® 




Europaisches Patentamt 
Eur pean Patent Office 
Office uropeen des brevets 



© Publication number: 



0 632 377 A1 



EUROPEAN PATENT APPLICATION 



© Application number: 94110016.6 


© Int. CIA G06F 11/00 


@ Date of filing: 28,06.94 




® Priority: 30.06.93 US 85621 


■ " • 

5623-294th Avenue N.E. 




Carnation, 


© Date of publication of application: 


Washington 98012 (US) 


04.01.95 Bulletin 95/01 


Inventor: Day, Robert F. 


© Designated Contracting States: 


19906 Filbert Drive 


Bothell, 


DE FR GB 




Washington 98012 (US) 


© Applicant: MICROSOFT CORPORATION 




One Microsoft Way 


© Representative: Patentanwalte Griinecker, 


Redmond, 


Washington 98052-6399 (US) 


Kinkeldey, Stockmair & Partner 




Maximilianstrasse 58 


@ Inventor: Blake, Russel P. 


D-80538 Munch en (DE) 



rs 
rs 

CO 

CM 
CO 
CO 



® Method for testing a message-driven operating system. 

© A simulation system to simulate the execution of a computer program. The computer program is developed 
for invoking operating system functions of a first operating system. Each operating system function performs a 
behavior in accordance with passed parameters. The simulation system generates a log during the execution of 
the computer program under control of the first operating system. The log includes an indication of each 
invocation of an operating system function by the computer program and an indication of each parameter 
passed to the operating system function by the computer program and the current time. The logged execution is 
then simulated by the simulation system on a second operating system. The simulation system invokes an 
operating system function of the second operating system to perform a behavior similar to the behavior 
performed by each logged invocation of the operating system function of the first operating system in 
accordance with the passed parameters. Comparison of the functionality, reliability, and performance of the two 
systems are thereby enabled. 
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Technical Field 

This invention relates generally to a computer method and system for simulating the execution of a 
computer program. 

5 

Background of the Invention 

Computer operating systems are very complex computer programs. When developing or modifying an 
operating system, it is critical that the operating system be thoroughly tested. The testing of an operating 

io system typically involves several testing phases. First, the programmer who writes a program for the 
operating system performs "unit testing." This unit testing ensures that the program functions as intended 
by the programmer. Second, the programmers who developed various programs perform integration testing. 
This integration testing ensures that the various programs function together correctly. Third, the developer 
of the operating system performs alpha testing of the operating system. During alpha testing, application 

75 programs are executed with the operating system and any anomalies are logged for later correction. Finally, 
end users of the operating system perform beta testing. The beta testing ensures that the operating system 
will function correctly in the end user's environment. 

The testing of an operating system can be very time consuming and expensive. Furthermore, it is 
virtually impossible to ensure that the operating system is error free. Generally, operating system 

20 developers concentrate on ensuring that the operating system will function correctly with "standard 
applications." A standard application is an application program that a typical user of the operating system 
may use. By testing with these standard applications, a developer can help ensure the operating system will 
function correctly in most typical situations. 

Certain operating systems are referred to as message-driven operating systems. One such operating 

25 system is Windows 3.1, developed by Microsoft Corporation. A description of Windows 3.1 is provided in 
the Software Development Kit for Windows 3.1, which is available from Microsoft Corporation and is hereby 
incorporated by reference. The Windows operating system provides a windowing environment for applica- 
tions that support a graphical user interface (GUI). Figure 1 is a block diagram illustrating the messaging 
architecture of a typical message-driven operating system. An application program 110 contains a main 

30 procedure 111 and a window procedure 112. When the application program 110 is executed under the 
control of the operating system, control is passed to the main procedure 111. The main procedure 111 
typically creates and displays a window and then enters a message loop 113. When executing the message 
loop, the application program 110 waits to receive a message from the operating system 120 indicating an 
external event (e.g., key down). The messages received by the message loop are referred to as posted 

35 messages. When a message is received, the application program 110 processes the message by 
requesting the operating system 120 to dispatch the message to the appropriate window procedure. The 
application program 110 includes a window procedure 112 for each window that is displayed on display 
monitor 130. A window procedure is invoked by the operating system when a message is dispatched to that 
window or when the operating system sends (discussed below) a message to that window. The window 

40 procedure decodes the message and processes the message accordingly. For example, a message 
dispatched to the window procedure may indicate that a character has been depressed on the keyboard 
when the window has the focus. A window that has the focus receives all keyboard and mouse inputs. 

The operating system 120 provides various functions to application programs that provide services to 
the application programs. These functions may include: RegisterClass, CreateWindow, ShowWindow, 

45 GetMessage, DispatchMessage, and DefWindowProc. These functions are collectively referred to as the 
application programming interface (API) provided by the operating system, and each function may be 
individually referred to as an API. During execution of the application program 110, the application program 
invokes the various functions provided by the operating system. These functions are typically stored in a 
dynamic link library. When the application program is initially loaded into memory, it dynamically links to 

so each of the functions it uses. As shown by the main procedure 111, the application program 110 initially 
invokes the function RegisterClass to register a window class with the operating system. Each window class 
has an associated window procedure for processing messages that are sent to a window. The operating 
system maintains a window class table 122, which correlates a window class with its window, procedure. 
When a window class is registered, the operating system stores the address of the window procedure in the 

55 window class table 122. When a message is, to be sent to a window, the operating system invokes the 
associated window procedure passing it various parameters including the type of the message. 

A window procedure is a type of a callback routine. A callback routine is a routine that is part of the 
application program but is invoked directly by the operating system. The application program provides the 
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operating system with the address of a callback routine that is developed to perform application-specific 
processing. The operating system then invokes the callback routine to perform the processing. 

The operating system also maintains a message queue 121 for the application program 110. The 
message queue 121 contains. messages that are posted to the application program. Each invocation of the 

5 function GetMessage in the message loop 113 retrieves a message from the message queue 121. The 
posted messages in the message queue typically correspond to external events such as mouse movement. 
When the operating system detects mouse movement over the window on the display monitor 130, the 
operating system posts a message to the message queue for the application program. The application 
program during the message loop retrieves each posted message and invokes the function DispatchMes- 

io sage to process the message. The function DispatchMessage determines which window procedure the 
message is directed to and sends the message to that window by invoking its window procedure. Not all 
messages are posted, dispatched, and then sent to the window procedure. The operating system 
sometimes sends messages directly to a window procedure, without first posting the message to the 
message queue. For example, when a window is first created, the operating system may send a create 

75 message (WM_CREATE) to the window procedure for that window. This message allows the window 
procedure to perform initialization of the window. 

Summary of the Invention 

20 It is an object of the present invention to provide a method and system for simulating the execution of a 
computer program to facilitate the testing of an operating system. 

It is another object of the present invention to provide a method and system for testing an operating 
system using application programs that have not yet been converted to execute under the operating 
system. 

25 These and other objects, which will become apparent as the invention is more fully described below, 
are provided by a method and system for simulating the execution of a computer program. In a preferred 
embodiment, a computer system simulates an execution of a client program that requests services of a first 
server program. During execution of the client program, the requests for services are logged. A simulation 
program receives the logged requests for services and requests a second server program to simulate the 

30 behavior of the requested service. In another preferred embodiment, a simulation system simulates the 
execution of a computer program. The computer program is developed for invoking operating system 
functions of a prior operating system. Each operating system function performs a behavior in accordance 
with passed parameters. The simulation system generates a log during the execution of the computer 
program under control of the prior operating system. The log includes an indication of each invocation of an 

35 operating system function by the computer program and an indication of each parameter passed to the 
operating system function by the computer program. The logged execution is then simulated on a new 
operating system. The simulation system invokes an operating system function of the new operating system 
to perform a behavior similar to the behavior performed by the logged invocation of the operating system 
function of the prior operating system in accordance with the passed parameters. 

40 

Brief Description of the Drawings 

Figure 1 is a block diagram illustrating the messaging architecture of a typical message-driven 
operating system. 

45 Figures 2A, 2B, and 2C are block diagrams illustrating the recording of the interaction and the 
simulation of an application program. 

Figure 3 is a block diagram illustrating a preferred architecture of the logger. 
Figure 4 is a flow diagram of a sample substitute function. 
Figure 5 is a flow diagram of a routine to log a function invocation, 
so Figure 6 is a flow diagram illustrating the recording of a typical integer parameter that is passed by 
value. 

Figure 7 is a flow diagram illustrating a routine that records a parameter that is passed as a pointer to a 
buffer. 

Figure 8 is a flow diagram of the processing of a parameter that points to a callback routine. 
55 Figure 9 is a flow diagram of a typical substitute callback routine. 

Figure 10A is an overvi w diagram illustrating the synthetic GUI application. 
Figure 10B is a flow diagram of the synthetic GUI application program. 
Figure 1 1 is a flow diagram of the routine GenerateSentMessageFile. 
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Figure 12 is a flow diagram of the routine GeneratePostedMessageFile. 

Figure 13 is a flow diagram of the SGAEngine routine. 

Figure 14 is a flow diagram of the routine FindMessagelnSentMessageFile. 

Figure 15 is a flow diagram of the routine SimulatePostedMessage. 
5 Figure 16 is a flow diagram of a routine that simulates the posting of the WM KEYDOWN message. 

Figure 17 is a flow diagram of a routine that simulates a WM_MOUSEMOVE message. 

Figure 18 is a flow diagram of a thunk window procedure. 

Figure 19 is a flow diagram of the routine ThunkRegisterClass. 

Figure 20 is a flow diagram of the routine ThunkCreateWindow. 
w Figure 21 is a flow diagram of the procedure ThunkDestroyWindow. 

Figure 22 is a flow diagram of a template thunk function. 

Figure 23 is a block diagram illustrating an alternate embodiment of the present invention. 
Detailed Description of the Invention 

75 

The present invention provides a method and system for simulating the execution of an application 
program. In a preferred embodiment, the simulation system first records the interaction between the 
application program and an existing operating system (an old operating system) during an execution of the 
application program. The simulation system then takes this recorded interaction and simulates the 

20 interaction with a new operating system. 

To record the interaction, the simulation system executes the application program under the control of 
the old operating system. During execution of the application program, a logger portion of the simulation 
system records each invocation of an operating system function by the application program and records 
each invocation of a callback routine by the operating system. The logger also records all the parameters 

25 passed to each function and all the parameters returned . by each callback routine. The logger also 
preferably records all parameters returned by each function and all parameters passed to each callback 
routine. The logger records this information in a log file. 

The simulation system then simulates the execution of the application program on a new operating 
system. A synthetic GUI application (SGA) of the simulation system inputs the log file and invokes the 

30 functions of the new operating system to effect the behavior of the logged function invocations. The SGA 
also provides thunk callback routines for the new operating system to invoke. The thunk callback routin s 
. simulate the behavior of the real callback routines of the application program. The SGA also simulates the 
occurrence of the real events (e.g., key down) that occurred during the execution of the application 
program. By effecting a behavior in the new operating system that corresponds to the behavior that 

35 occurred during the execution of the application program under the old operating system, the execution of 
the application program on the new operating system is simulated. 

Testers of the new operating system can then compare the output of the simulation to ensure that it 
correctly corresponds to the execution of the application program under the old operating system. Also, the 
return parameters from the functions of the new operating system can be compared to the recorded 

40 returned parameters from the function of the old operating system to determine whether the new operating 
system is working correctly. Also, the time taken to perform the functions on the new operating system can 
be compared to the time taken to perform the functions in the old operating system. 

Figures 2A, 2B, and 2C are block diagrams illustrating the recording of the interaction and the 
simulation of an application program. Figure 2A illustrates the interaction between application program 210 

45 and an old operating system 220. The GUI application program 210 invokes the functions of the old 
operating system 220, and the old operating system 220 invokes the callback routines of, the GUI 
application program 210. Figure 2B illustrates the logging of the invocations of the functions and the 
callback routines during the execution of the application program 210. When the application program 210 
invokes a function, the logger 230 records the passed parameters for the function and the function name to 

so a log file 240. When the function returns to the application program, the logger also records all returned 
parameters to the log file. When the old operating system 220 invokes a callback routine, the logger 230 
records a callback routine identifier and the passed parameters. When the callback routine returns to the old 
operating system 220, the logg r records the returned parameters to the log file! The time associated with 
each interaction is recorded. Figure 2C is a block diagram illustrating the simulation of the execution of the 

55 application program 210 that is recorded in, the log file. To simulate the execution of the application 
program 210, the synthetic GUI application 250 (SGA) inputs the log file that records the execution. The 
SGA simulates each function invocation represented in the log file by invoking none, one, or more functions 
of the new operating system 260. The SGA simulates the behavior of the function invocation based on the 
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recorded passed parameters. The SGA 250 also provides a thunk callback routine for each real callback 
routine of the application program. The SGA 250 passes these> thunk callback routines to the new operating 
system 260. When the new operating system 260 invokes a thunk callback routine, the thunk callback 
routine simulates the processing of the real callback routine based on the information in the log file. 
5 Specifically, the thunk callback routine may simulate the posting and sending of messages and the invoking 
of functions that occurred during the execution of the real callback routine. 

The Logger 

w Figure 3 is a block diagram illustrating a preferred architecture of the logger. For each function 221 that 
the old operating system 220 provides, the logger provides a substitute function 311. The logger also 
provides a substitute callback routine 312 for each callback routine of the application program. When the 
GUI application program 210 is initially loaded, all function calls by the application program link to a 
substitute function 311, rather than the real function 221 in the old operating system. When the application 

75 program 210 invokes a function, the substitute function records the invocation to a log file along with each 
passed parameter and the current time. The substitute function then invokes the real function of the old 
operating system 220 with the passed parameters. When the real function returns to the substitute function, 
the substitute function records the return along with the returned parameters to the log file and the current 
time. The substitute function then returns to the application program with the parameters returned by the 

20 real function. In this way, the recording of the log file is functionally transparent to the application program. 

The real functions of the old operating system are typically stored in a dynamic link library. The 
executable file containing the application program contains the name of each dynamic link library that the 
application program invokes. During initial loading of the application program, each invocation of a real 
function is bound to the real function in the dynamic link library. In a preferred embodiment, each dynamic 

25 link library with real functions is associated with a substitute dynamic link library and is given a name with 
the same number of characters as the name of the "real" dynamic link library and a slight variation of the 
name of the real dynamic link library. For example, the name "Zernel" may be given to the substitute 
dynamic link library corresponding to the real dynamic link library "Kernel." When the execution of the 
application program is to be logged, each real dynamic link library name in the executable file is replaced 

30 by a substitute dynamic link library name. Thus, when the application program is loaded, the application 
program dynamically links to the substitute dynamic link libraries, rather than the real dynamic link libraries. 

The addresses of callback routines are typically specified to the old operating system by a parameter 
passed to a function. For example, the address of a window procedure callback routine is specified to the 
old operating system as a parameter when invoking the function RegisterClass. The substitute function 

35 associated with each real function, that is passed as a callback routine, substitutes a substitute callback 
routine for the real callback routine. The substitute function invokes the real function specifying the 
substitute callback routine 312 rather than the real callback routine 211. When the old operating system 220 
sends a message to the application program 210, it invokes the substitute callback routine 312. The 
substitute callback routine records the invocation of the callback routine along with the passed parameters 

40 and the current time. The substitute callback routine then invokes the real callback routine 211 with the 
passed parameters. When the real callback routine returns to the substitute callback routine, the substitute 
callback routine records the return along with the returned parameters. The substitute callback routine then 
returns to the old operating system with the returned parameters. 

When a substitute function or a substitute callback routine records its invocation, it also records a 

45 nesting level. The nesting level indicates the level of invocations of the functions and callback routines. For 
example, when an application program invokes the function Dispatch Message, the nesting level is 1 
because no other function or callback routine is currently invoked. If, during the execution of the function 
DispatchMessage, the function invokes a callback routine, then the nesting level of the callback routine is 2. 
If that callback routine then invokes a function (e.g., function DefWindowProc), then the invocation of that 

so function is at nesting level 3. If the function at nesting level 3 invokes a callback routine, then the nesting 
level of the callback routine is 4, and so on. Alternatively, the nesting level of an invocation can be 
determined from th log after completion of the execution of the application program, rather than during 
execution. 

Figure 4 is a flow diagram of a sample substitute function. The substitute function has the same calling 
55 prototype (that is, the same function type and the same number and type of parameters) as the real 
function. In a preferred embodiment, the substitute function is generated automatically from a "header" file 
. that defines the original functipn to the application. The substitute function records the invocation of the 
function along with the passed parameters and the current time and the return of the function along with the 
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returned parameters and the current time. The substitute function invokes the real function. The substitute 
function ensures that the real function is passed the same param ters that it receives, and ensures that the 
application program is returned the same parameters that the real function returns. In step 401, the 
substitute function saves the current state of the CPU, . which may include saving, the registers. The 

5 substitute function ensures that CPU state is restored to this saved state before. the real function is invoked. 
In step 402, the substitute function increments the nesting level. In step 402A, the substitute function 
retrieves the current time. In step 403, the substitute function records the function invocation and passed 
parameters and the current tame. In step 404, the substitute function restores the slate of the CPU to the 
state saved in step 401. In step 405, the substitute function invokes the real function with the passed 

io parameters. In step 406, the substitute function saves the state of the CPU upon return from the real 
function. The substitute function ensures that the CPU state is restored to this saved state before the 
substitute function returns. In step 406A, the substitute function retrieves the current time. In step 407, the 
substitute function records the return and returned parameters and the current time. In step 408, the 
substitute function decrements the nesting level. In step 409, the substitute function restores the CPU state 

15 saved in step 406 and returns to the application program. 

Figure 5 is a flow diagram of a routine to record a function invocation to a log file. The routine writes an 
identification of the real function (e.g., function name) to the log file along with all the parameters passed to 
the real function and the current time. The log file preferably includes an entry (e.g., a line) for each 
recorded invocation and return of a function or callback routine. Each entry identifies whether it corresponds 

20 to an invocation or return of a function or callback routine. In step 501 , the routine writes the nesting lev I 
and function invocation identifier (e.g., "APICALL") to the log file and the current time. In step 502, the 
routine writes the function name (e.g., "RegisterClass") to the log file. In steps 503 through 505, the routine 
loops writing the passed parameters to the log file. The routine must write all the information to the log file 
that the real function may use when it executes. For example, if the real function prints a buffer of data to 

25 the display monitor, then the buffer may be pointed to by a pointer. The routine copies all the data in the 
buffer to the log file, not just the pointer. This actual data can then be redisplayed during simulation. In step 

503, if all the parameters have been processed, then the routine returns, else the routine continues at step 

504. In step 504, the routine retrieves the next parameter. In step 505, the routine processes the retrieved 
parameter and writes the data associated with the parameter to the log file, and then loops to step 503. 

30 Figure 6 is a flow diagram illustrating the recording of a typical integer parameter that is passed by 
value. The value of the parameter is retrieved and written to the log file. 

Figure 7 is a flow diagram illustrating a routine that records a parameter that is passed as a pointer to a 
buffer. The routine not only records the data pointed to by the passed pointer (the buffer), but also records 
any data pointed to by pointers in the buffer. In step 701, the routine writes a left brace to the log file. The 

35 left brace indicates the start of data that is pointed to. In step 702, if the next data item is a pointer, then the 
routine continues at step 704, else the routine continues at step 703. In step 703, the routine writes the non- 
pointer parameter to the log file. In step 704, the routine recursively calls itself to process the pointer. In 
step 705, if all the parameters have been processed, then the routine continues at step 706, else the routine 
loops to step 702. In step 706, the routine writes a right brace to the log file and returns. 

40 Figure 8 is a flow diagram of the processing of a parameter that points to a callback routine. In a 
preferred embodiment, each substitute function that is passed a callback routine includes an array of 
substitute callback routines. Each time the substitute function is invoked, it selects the next substitute 
callback routine in the array as the substitute for the passed callback routine. The substitute function also 
maintains a table that correlates each real callback routine to its substitute callback routine. For example, 

45 the substitute function for the function RegisterClass preferably contains an array of identical substitute 
window procedures. When each new window class is registered, the next unused substitute window 
procedure in the array is selected. Alternatively, a substitute function could create the substitute callback 
routines as needed. In step 801, the routine selects an unused substitute callback routine. In step 802, th 
routine maps the real callback routine to the substitute callback routine. In step 803, the routine substitutes 

so the address of the substitute callback routine for the address of the real callback routine in the parameter 
list and returns. 

Figure 9 is a flow diagram of a typical substitute callback routine. The typical substitute callback routine 
is analogous to the typical substitute function as shown in Figure 4. In step 901, the substitute callback 
routine saves the CPU state. In step 902, the substitute callback routine increments the nesting level. In 
55 step 902A, the substitute callback routine retrieves the current time. In step 903, the substitute callback 
routine records the invocation of the callback routine along with the passed parameters and current time to 
the log file. In step 904, the substitute callback routine finds the. address of the associated real callback 
routine. In step 905, the substitute callback routine restores the CPU state to the stat that was saved in 
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step 901. In step 906, the substitute callback routine invokes the real callback routine. In step 907, the 
substitute callback routine saves the CPU stat returned by the real callback routine. In step 907A, the 
substitute callback routine retrieves the current time. In step 908, the substitute callback routine records the 
return of the callback routine. along with the returned parameters and current time to the log file. In step 

5 909, the substitute callback routine decrements the nesting level. In step 910, the substitute callback routine 
restores the CPU state to the state that was saved in step 907 and the substitute callback routine returns to 
the invocation by the operating system. 

Table 1 contains a sample application program written in the "C" programming language. The 
application program creates and displays an instance of a window class named "Generic2Class" with the 

w window procedure named "MainWndProc". The window procedure handles the messages 

WM COMMAND, WM DESTROY, WM_PAINT, AND WM LBUTTQNDOWN. All other messages are 

passed by the window procedure to the operating system using the function QefWindowProc. The window 

procedure when sent a WM COMMAND message with the IBM ABOUT parameter invokes the function 

DialogBox with a pointer to the callback routine to handle messages to the dialog box. 

75 Table 2 contains a section of a log file for an execution of the sample application program of Table 1. 
Table 2 contains an entry (line) for each function and callback routine invocation and return. Each entry 
contains a line number (for reference), a nesting level, a vertical bar, timing information, another vertical bar, 
an identifier of the type of entry, the function name or callback routine identifier, and the parameters. For 
example, line number 7 contains an entry corresponding to an invocation of the function CreateWindow. 

20 The nesting level is 1. The function was invoked at time "9421 02B3". The entry type is "APICALL", which 
indicates the invocation of a function. The parameters are n Generic2Class", "Generic Sample Application", 
"CF00", etc. The entry corresponding to the return of the function CreateWindow is at line 24. Note that 
each nesting level in between lines 7 and 24 is at a level greater than 1. During the invocation of the 
function CreateWindow, the operating system sent the message "WM GETMINMAXINFO" to the callback 

25 routine passed to the function CreateWindow as indicated at line 8. An entry type corresponding to the 
invocation of a callback routine is "MSGCALL". 

Table 1 

30 



PROGRAM: Generiac 

PURPOSE: Generic template for Windows applications 
FUNCTIONS: 

WinMainO - calls initialization function, processes message loop 
InitAppiicationQ - initializes window data and registers window 
InitlnstanceO - saves instance handle and creates main window 
MainWndProcQ - processes messages 
AboutQ - processes messages for "About" dialog box 
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COMMENTS: 

Windows can have several copies of your application running at the 
same time. The variable hlnsr keeps track of which instance this 
application is so that processing will be to the correct window. 



HANDLE hlnst: /• current instance ./ 

HWND hWndSave; 



FUNCTION: WinMain(HANDLE. HANDLE, LPSTR, int) 
PURPOSE: cai. ; initialization function, processes message loop 
COMMENTS: 

. Windows recognizes this function by name as the initial entry point 
for the program. This function calls the application initialization 
routine, if no other instance of the program is running, and always 
calls the instance initialization routine. It then executes a message 
retrieval and dispatch loop that is the top-level control structure 
for the remainder of execution. The loop is terminated when a WM QUIT 
message is received, at which time this function exits the application 
instance by returning the value passed by PostQuitMcssage(). 

If this function must abort before entering the message loop, it 
returns the conventional value NULL. 



MSG MyMsg =* {0}; 

MMain( hlnstance, hPrevInstance. IpCmdLine, nCmdShow ) 

MSG msg; 
HDC hdc. 

if(!hPrevInstance) /«- other instances of app running'' */ 

if (!InitAppiication(hInstance)) /* Initialize shared things V 

return (FALSE); /* Exits if unable to initialize •/ 

/* Perform initializations that apply to a specific instance */ 

if (!liudnstance(hlnstance, nCmdShow)) 
return (FALSE); 

/* Acquire and dispatch messages until a WM QUIT message is received. V 
while ( GetMessage(&msg, NULL. 0.0) ) { 

MyMsg * msg; 

TransiateMessage(&msg); 

DispatchMessage(&msg); 

} 
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FUNCTION: InitAppiicauon(HANDLE) 

PURPOSE: Initializes window data and registers window ria^ 

COMMENTS: 

This function is called at initialization time only if no other 
instances of the application are running. This function performs 
initialization tasks that can be done once for any number of running 
instances. 

In this case, we initialize a window class by filling out a data 
structure of type WNDCLASS and calling the Windows RegisterClassO 
function. Since all instances of this application use the same window 
class, we only need to do this when the first instance is initialized. 



BOOL InitAppiication(hlnstance) 

HANDLE hlnstance; /* current instance •/ 

{ 

WNDCLASS we, 

/* Fill in window class structure with parameters that describe the •/ 
/* main window. */ 

wc.style = CS_OWNDC; /* Class sryle(s). •/ 

wcipfhWndProc = MainWndProc /* Function to retrieve messages for */ 

/* windows of this class. */ 
wc.cbClsExtra = 0: /* No per-ciass extra data. •/ 

wc.cbWndExtra = 4; /* No per-window extra data. "/ 

wc. hlnstance = hlnstance: /* Application that owns the class. */ 
wchlcon = LoadIcon(NULL. ©I JVPPUCATION); 
wchCursor = LoadCursor(NULU IDC_ARROW); 
wchbrBackground =* GetStockObject(WHrrE_BRUSH); 
wclpszMenuName « "GcnericMenu"; /* Name of menu resource in .RC file. •/ 
wclpszClassName * , 'Gcneric2Class ,, ; /* Name used in call to CreateWindow. •/ 

/* Register the window class and return success/failure code. */ 

return (RegisterClass(&wc)); 

} 



FUNCTION: InitInstance(HANDLE. int) 

PURPOSE: Saves instance handle and creates main window 
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COMMENTS: 

"Hiis function is called at initializadon time for every instance of 
this application. This function performs initialization tasks that 
cannot be shared by multiple instances. 

In this case, we save the instance handle in a static variable and 
create and display the main program window. 



BOOL Ixutlnstance<hlnstancc, nCmdShow) 

HANDLE hlnstance; f* Current instance identifier. */ 
{ mt nCmdShow; /* Parara for first ShowWindowO call. •/ 

HWND ^Vnd: /* Main window handle. •/' 

HWND hWndX; ' 
OFSTRUCT ofFileData; 
HANDLE hLogFile; 

/* Save the instance handle in static variable, which will be used in •/ 
/* many subsequence calls from this application to Windows. •/ 

hLogFile = OpenFiIe( "DATA-TXT", 

(LPOFSTRUCD&ofFileData. 

,ur ^ C ^ TE l° F - w WTEIOF_SHARE DENY NONE ); 
Jciose( hLogFile ); * - A 

hlnst s hlnstance: 

/* Create a main window for this application instance. V 

hWnd * CreateWindow( 
*Gcneric2Class\ /• See RegisterClassO call. v 

"Generic Sample Application", /• Text for window title bar •/ 
WS.OVERLAPPEDWTNDOW, /* Window style. 
°- /* Default horizontal position. V 

°- ** Default vertical position. */ 

0x *SO. /* Default width. */ 

OxiAS, /* Derault height */ 

NULL ^ Overlapped windows have no parent •/ 

NULL, /* Use the window class menu. V 

hlnstance, /• This instance owns this window. •/ 

NULL /* Pointer not needed V 

); 

hWndSave = hWnd; 
/* If window could not be created, return "failure - •/ 

if(!hWnd) 

return (FALSE); 

/* Make the window visible; update its client area; and return -success" •/ 

ShowWindow(hWnd. nCmdShow); /• Show the window ./ 
UpdateWindow(hWiid); /* Sends WM.PAINT message •/ 



10 



return (TRUE); 

} 
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/* Returns the value from PostQuiiMcssage "/ 



FUNCTION: MainWndProc(HWND, unsigned, WORD, LONG) 

PURPOSE: Processes messages 

MESSAGES: 

WM_COMMAND • application menu (About dialog box) 
WM_DE5TROY - destroy window 

COMMENTS: 

To process the IDM_ ABOUT message, call MakeProdnstance() to get the 
current instance address of the AboutQ function. Then call Dialog 
box which will create 'he box according to the information in your 
generic, rc file and turn control over to the About() function. When 
it returns, free the intance address. 

tfifdefWIN16 

typedef DWORD ULONG; 

typedef DWORD BOOLEAN; 

typedef struct large_integcr { 

ULONG LowPan; 

LONG HighPan: 
} LARGE^INTEGER. FAR *LPLARGE_INTEGER; 

VOID RtlConvertLongToLargeInteger( 
LPLARGE INTEGER lpli. 
LONG I 

){ 

if(l<0){ 

lpii->HighPan = -lL; 
}clse{ 

lpli-> HighPan = OL; 

} 

lpli->LowPan * (ULONG)I; 

} 

VOID RtlLargeintegerSubtract( 
LPLARGE_INTEGER IpliResuit, 
LPLARGE^rNTEGER lpiiSubtrahend, 
LPLARGE INTEGER lpiiMinuend 

)< 

lpliResuit->LowPan « lpliSubcrahend->LowPart - lpliMinuend->LowPart; 
if ( (LONG)(IpliResult->LowPan) < 0 ) { 

lpiiResuit->HighPan 53 (lpliSubtrahend->HighPan-l) - lpliMinuend->HighPart; 
}else{ 

IpliResult->HighPan « Ipii Subtrahends HighPan - 1 piiMimiend->Hi ghPan; 



11 



EP 0 632 377 A1 



} 

) 

^define RtiLargeIategerGrcaierThan(X > Y) ( \ 
(X).ffighPan>(Y).ffighPan?TTCJE: \ 
(X) JfighPan < OOJBghPait ? FALSE : \ 
(X).LowPan > OOXowPan ? TRUE : \ 
FALSE) 



Refine RTLCONVERTLONGTOLARGEINTEGER( x. y ) RUConvenLongToLaigeiiitegcK &(x), 
Wefine RTLLARGETNTEGERSUBTRACT( x, y. z ) RtlLargeImegerSubtract( i(x). ttfy), &( Z ) ) 

^define RTLCONVERTLONGTOLARGEINTEGER( x, y ) x = RdConvcnLongToLareeliaearf y ) 
fctefine RTLLARGEINTEGERSUBTRACT( x. y, z ) x = RULargeintegerSuboaa( y. I) 
#endif 

BOOL fmsgTime = FALSE; 

int msgCoum = 0; 

int msgArray( 100] = {0}; 

LARGE_INTEGER msgrunc(lOO) = {0}; 

LPOITTLINETEXTMETRIC Ip; 

long FAR PASCAL MainWndProc(hWnd, message. wParant IParam) 
HWNDhWnct /• window handle •/ 

UINT message: /* type of message •/ 

WPARAM wParam; /• additional information •/ 

LONG IParam: /* additional informaiion */ 

{ 

FARPROC IpProcAbout; /* pointer to the - About" function V 

PAINTSTRUCT pr, 
long rc: 

im i; 

LARGE_INTEGER liFreq; 
switch (message) { 

case WM ^COMMAND: I* message: command from application menu •/ 
switch( wParam ) { 
case IDM_ ABOUT: 

IpProcAbout » MakeProcinstance(Abouu hlnst); 

DialogBox(hInst /• current instance •/ 
"AboutBox", /* resource to use */ 
hWnd. /* parent handle */ 

IpProcAbout); /* AboutO instance address */ 

FreeProcirLStance(lpProcAbout); 

break; /* Lets Windows process it •/ 

case EDM DIV0: 

{ 

int i.j ; 

char text(50J; 

i=*5; 
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while (i> a 0){ 
j =» 360/i; 

wsprintfltext"! = %d j =» %<ftn\ i, j ); 

— i; 

} 

} 

break: 
default: 

return (DefWindowProc(hWnd, message, wParam, iParam)); 

} 

case WM_DESTROY: /* message: window being destroyed */ 

PostQuitMessage(0); 
break: 

case WM PAINT: 
{ 

WNDCLASS wc; 
- LPSTR lp; 
HDC hDC; 
PAINTSTRUCT ps; 
char text(10O|; 

HWND hwnd2; 
ATOM Atom: 
int re, 
HBRUSH hbr, 
LPSTR lostn 
int x: 
int y; 

hDC » BeginPaim( hWnd &ps ); 

!psu => (LPSTR)"Hi There 

hbr - CreaieSolidBrush( RGB(Ox30.Ox30.0) ); 

GrayString( hDC hbr, (GRAYSTRINGPROQNULL, (LPARAM)Ipstr, 0, 10, 10, 0, 0 ); 

SetBkModc( hDC, TRANSPARENT); 
SetTextColor( hDC, RGB(O,O,0) ); 

x » 150; y ■ 150; 

TextOuK hDC x-L y-l, "Testing 2*. 9 ); 
TextOut(hDC x, y-l. Testing 2", 9 ); 
TextOut( hDC x+1, y-l. Testing 2", 9 ); 
TextOut( hDC x-l, y, Testing 2\ 9 ); 
TextOut( hDC x+1, y t Testing 2", 9 ); 
TextOuK hDC, x-l, y+1, Testing 2", 9 ); 
TextOut(hDC x. y+l. Testing 2", 9 ); 
TextOut( hDC x+l, y+l. Testing 2". 9 ); 

SetTextCoM hDC, RGB(OxFF,0xFF,0xFF) ); 
TextOut( hDC, x, y p Testing 2", 9 ); 

EndPaim( hWnd, &ps ); 
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} 

break; 

case WM LBUTTONDOWN: 

{ 

unsigned short i; 
unsigned short j; 

j-l: 

while ( j <= 200 ) { 

while ( i ) { 
_asm { movaXax }; 

i-K f 

} 

} 



> 



} 



de&ute /'Passes it on if unprocessed V 

re - DefWindowProc(hWiut message, wParam, IParam)- 
remrn( rc ); 

} 

return (NULL); 



FUNCTION: About(HWND. unsigned, WPARAM. LONG) 
PURPOSE: Processes messages for ■About" dialog box 
MESSAGES: 

WM_INITDiALOG - initialize dialog box 
WM_COMMAND - Input received 

COMMENTS: 

No initialization is needed for this particular dialog box. but TRUE 
must be returned to Windows. 

Wait for user to dick on "Ok" button, then close the dialog box. 



BOOL FAR PASCAL About(hDlg, message, wParanu IParam) 

/* window handle of the dialog box •/ 
UINT message; /* type of message v 

WPARAM wParam; /• m ~«„.' 

LONG IParam: message-specific informauon •/ 

{ 
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switch (message) { 

case WM_IN1TDIAL0G: /* message: initialize dialog box •/ 

return (TRUE); 

case WM.COMMAND: /• message: received a command •/ 

if (wParam — IDOK /* "OK" box selected? •/ 

II wParam — IDCANCEL) { /• System menu dose command? •/ 
EndDialogChDlg, TRUE); /* Exits the dialog box •/ 
renirn (TRUE); 

> 

break; 

} 

return (FALSE); /* Didnt process a message •/ 



TABLE 2 
LOG FILE 

L 01I842053E6lAPICAU.:ReqisterC:a3S (20 0B3rO2O8 3 4 3I£ 36 E 19 E 5C 'GenericMenu" 
"Generic2Cla«- J 0A1FOU7 

2 01 1 84 206B9B I APIRET:ReqisterC; ass C03E 

3 01I84206EFAlAPICAU.:OpenfIle -?:M£.-.CG" { 2 1A 31F 37 A7 o 0 } 1041 

A 01l8420CF03lAPIRET:Openfile 5 (21 1 0 ZZ LA FB H 44 3A 5C 54 45 53 54 S3 5C 47 
45 4E 45 52 49 43 £C 54 49 40 45 2S 4C 4F 47 0 } 

5 0118420DA£DlAPICALL:_Lclo3e 5 

6 01l8420E570lAPIRET:_Lcioae 0 

7 01l842102B3lAPICALL;Create«in<lov "Generic2C:ass" Generic Sample Application- 
CFOOOO 0 0 290 1A5 0 0 31E 0 

9 02)842I49C5IMSGCALL:OB3F0208 9A 24-WJSE7MINMAXINFO 0 {24 24} (408 308} { FFFC 
FFFCJ {66 1AI {4 08 308 } 

9 03l842HFBCIA?lCALX.:0«fWinaowPr3C 3A 24-W4_GE7MINMAXINFO 0 {24 24 1 (408 308} { FFFC 
FFFC I {66 iAI (408 308} 

10 03l842155B01APIRET:DefWindovProc 0 

11 02I8421S8D6(MSGRET:0 083F0208 3A 24 -WM_GET74INMAXINFO 0 {24 ZA\ {408 308} {FFFC 
FFFC) {66 LAt (408 308} 

12 02I84 21662BIMSGCAU.:083F0208 9A 3 1 - WM_NCCREATE 0 {0 31E 99 0 IAS 280 0 0 CFO0O0 
"Generic Sample Application" "5eneric2Ciass" 0} 

13 03l84216EA3lAPICALL;OetHinaowProc 9A 3 1 -WM_MCCREATE 0 {0 91E 39 0 1A5 280 0 0 
CF0OO0 "Generic Sample Application- -Generic2Class" 0} 

14 03l84217BlllAPIRET:0eOltndowProc i 

15 02l84217E4 9 IMSGRET:i DB3F0208 3A 3 1 -WM_NCCREATE 0 {0 B1E 39 0 1A5 280 0 0 CFOOOO 
"Generic Sample Application- -Generic2CIass* 0} 

16 02i8421B8CF|KSGCAIX;OB3F0208 8A 83-MM_NCCALCSIZE 0 {0 0 280 LAS} 

17 03l84218CC7|APICALL;Oe£KlndowProc 9A 93-WM_NCCALCSI2E 0 (0 0 280 1A5} 
IB 03l842199ADIAPIRET:DemnaowProc 0 

19 02I84219CE0IMSGRET:0 0B3F0208 8A 3 3-WMJICCALCSI2E 0 ( 4 2A 27C 1A1} 

20 0218421A4DBIMSGCALL:OB3F0208 3A 1-WM_CREATE 0 {0 31£ 99 0 1A5 280 0 0 CFOOOO 
-Generic Sample Application- -Generic2Class" 0} 

21 03l8421AC7FIAPICALL:0efWtndovProc 3A 1 -WM_CREATE 0 {0 B1E 89 0 IAS 280 0 0 CFOOOO 
-Generic Sample Application" "GenericCClasa" 0} 

22 03l8421B4 9C!APIRET:0emndowProc 0 

23 02I8421B7A£|MSGRET:0 0B3F0208 9A :-WM_CREATE 0 {0 31E 99 0 IAS 280 0 0 CFOOOO 
"Generic Sample Application" "Generic2Cla*»- 0) 

24 01|84 21C18AIAPIRET:Create«inaow 9A { 0 0 280 1AS| (0 0 280 LAS) 
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25 01 1 84 21C541 > APICALL; ShowWinoov 3A : 

:6 32 ! 84 2ICCC3 IMSGCALL: 0B3FO208 3A 1 9-*H_3HCWWINDOW : 0 

27 03 1 84ncrS«J I APICALL: DeiWindowProc 9A 18-WM_SHOWWINDOW 1 0 

23 03) 84 210383 1 APIRET :D*fWinoowProc 0 

5 29 02|8421069BlMSGRET:O 0B3F0208 3A ;8-WM_SHOWWINDOW 10 

30 02(84 21E:96tMSGCALL;OB3F0208 3A 4 6-WMJUN DOW POSC HANGING 0 C370180 

31 031 84 21E55E I APICALL: OefWindowProc 3A 4 6-*#1 J/IINDOWPOSCHANGING 0 C37O180 

32 03l8421EABBlAPIRET:0efWindowProc 0 

33 021 8421£0E5tMSGRET:0 OB3F0208 3A 4 6-WM JftNDCHPOSCHANGXNG 0 C370180 
1Q 34 021 64 22093 F I MSGCALL: 0B3F0208 3A 3 0F-«H_3UERYNEW PALETTE 0 0 

35 031 8 4 22 0055 1 APICALL: Da fWlndovProc 3A 3 0 F-WM_CM ERYN EW PALETTE 0 0 

36 031 84221483 1 APIRET: OefWindowProc 0 

37 02I842217ABIMSGRET:0 0B3F0208 3A 30 F-WHJ3U ERYN EH PALETTE 0 0 

38 021 84 221 F6C J MSGCALL: 0B3F02 08 3A 4 6-WMJ/IIN0OHPOSCHANGING 0 C370180 

39 03 1 84222313 1 A **CALL: OefWindowProc 9A 4 6-W_WINDOWPOSCHANGING 0 C37O180 
75 40 031 842227BClAPiRET:0«fWlnaowProc 0 

41 02IB4 222AD7|MSGRET:0 OB3F0208 3A 4 6-*iM_WlNOOWPOSCHANGING 0 C370180 

4 2 021 84 223361 IMSGCALL: 0B3F02 08 3A :C-WM_AC7IVATEAPP 10 0 

43 031 8422370AIAPICALL;0efWlnaowProc 3A :C-WM_ACTIVATEAPP 10 0 

44 '031 B4223AEF!APIRET:OeCUnaowProc 0 

20 45 02I84223DF4IMSGR£T:0 0B3F0208 3A :C-WM_ACTr/ATEAPP 10 0 

46 02 1 84224454 IMSGCALL: 0B3F0208 3A 3 6 -WM_MCACT Z VATE 1 0 

4 7 031 8422 4 7BA I APICALL; OefWindowProc 3A 36-WH_NCACTIVATE 1 0 

4 8 04 t 84 2257 60 IMSGCALL; 0B3F0208 iA 3-WM_3ETTEXT 4F 0C37018O 

4 9 051 84 22SB46IAPICALL;0efWinaowProc 3A 0-WM_G£T7E:CT 4F OC370180 

50 051 84 2262"' 01 APIRET: OefWinaowProc 1A 

25 51 04ia42265B4lMSGRET:iA 0B3F0208 3A 3-«M_SETTEXT 4F "Generic Sample Application- 

52 03 t842270BEi APIRET: OefWinaowProc 1 

53 02 184 22 9 34 9 (MSGRET:! OB3F0208 3A 36-WM_SCACTIVATE 1 0 

54 02 J84 223C38 I MSGCALL: 0B3F0208 3A o-WM_ACTIVATE 10 0 

55 031 842290171 APICALL; OefWinaowProc 3A 6-aM_ACTIVATE 10 0 
3Q 56 04 1 84 2297131 MSGCALL: 0B3F02O8 3A "-WM_3E7FOCJS 0 0 

57 051 84 22 9A7 8 1 APICALL: OefWindowProc 3 A ~-WH_JETrCCJS 0 0 

58 0518422A22C:APIRET:OefWindowProc 0 

£9 04 184 22A556lMSGRET:0 0B3F0208 5A ~ -f*M_3ETFOCJS 0 0 

60 031 842ZC408 1 APIRET : OefWinaowProc 3 

61 021 84 22C3321MSGRET:0 3B3F0208 3A 6-WM_ACTr/ATE I 0 0 
35 62 021 84 22003E IMSGCALL; OB3F02 08 3A 35-i4M_NC?AINT £4 0 

63 031 84 2203A8 1 APICALL; OefWindowProc 3A 35-WM_NCPAIN7 E4 0 

64 04 (8422 F4 191 MSGCALL; 0B3F0208 3A D-WM_GETTEXT 4F 0C370180 

65 051 84 22F7F0 1 APICALL: OefWindowProc 3A D-WM_GETTEXT 4F 0C37O1BO 

66 051 8 4 22 FCBB I APIRET; OefWindowProc 1A 

57 04I8423063A)MSGRET;1A OB3F0208 3A 0-WM_GETTEXT 4F "Generic Sample Application" 

68 031 842317 911 APIRET: OefWindowProc 0 

59 02184231ADAIMSGRET:0 0B3F0208 3A 35-WMJ4CPAINT E4 0 

70 021 84 232218 IMSGCALL: OB3F0208 3A 1 4 -WM_SRASE8KGND £4 0 

71 03) 84 232599 1 APICALL: DefWinoowProc 3A 1 4 -**M_ERASEBKGN0 £4 0 
7 2 03 1 842331A7 I APIRET: OefWindowProc 1 

45 7 3 02 1 842334 E8 1 MSGRET: 1 0B3F0208 3A 14-WM_£RASEBKGN0 £4 0 

'4 021 84233 01 Bf MSGCALL: 0B3F02 08 9A 4 7-WM_'<ttNDCMPOSCHANG£D 0 C370180 

75 031 8423 40CC1 APICALL: OefWinaowProc 3A 4 7-^ J4INDCWPOSCHANGED 0 C370180 

76 031 84234 590 IAPIRET: OefWindowProc 0 

77 02 1 4 235DB8 i MSGRET : 0 0B3F02O8 3A 4 7-W1_WTNDCWPOSCHANGED 0 C37018O 

78 021 84 23651AI MSGCALL :0B3F0208 3A 5-WM SIZE 3 1770278 
50 ~ 

7 9 031 84 2368 65 1 APICALL: OefWindowProc 3A 5-«*_s:-£ 0 1770278 

90 031 84 236C33 1 APIRET: OefWindowProc 1 
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31 02l84236F33lMSGRET:O 083F0208 3A S-WM^SIZE 0 1770278 

32 02|94 237 4 6AIKSGCALL:083F0208 3A 3-VWJ40VE 3 2A0004 

33 03l84 2377 96IAPICAU.:OofWlndowProc 3A 3-«M_MOVE 0 2A00O4 

34 33|84237B3EIAPIRET:De£WinaowProc 0 

5 

35 02I84 237E4 4 IMSGRET:0 OB3F0208 3A 3-WM_MOVE 0 2A0004 

36 31 1 84238324 I APXRET: ShowWLnaow FALSE 

37 31 1 8423860DI APICALL: UpdateWindow 3A 

38 32l84238C3SiMSGGALL:OB3F0208 3A F-WM_ PAINT 0 0 
89 03 1 84238 FECI APICALL; BegmPamt 9A 

70 30 33l84 239706lAPIRET:3eginPaint E4 {E4 FALSE (0 0 278 177} FALSE FALSE 17 1 IF 8A 

3A 0 FF FF 14 0 0 0 95 5 9E 0 } 

. 91 03| 84 23A21C;APICALL; Create Sol idBruah 3030 

92 03l8423B05DIAPIRET:CreateSolidBrusn TO 

93 031 84 23B3A5 1 APICALL; ScaySt ring £4 TO MULL <SQ a 31F0473 0 A A 0 0 

94 03I84 23C2E3I/ ~ T RET:GrayStnng TRUE 
15 95 03l8423C643lAPICALL:SetBkMooe £4 1 

96 03l8423CD83|APXRET:Set9kMode 2 

97 031 84 23EE061 APICALL; SetTextColor E4 0 

98 03t8423F489lAPIRE7:SetTextCoior 0 

39 *03 1 8423 FB39 1 APICALL: TwxtOut ZA 95 95 "Testing 2" 9 
2Q 100 03l8424OO65lAPIRE7:7extOut TRUE 

101 331 84 24 034 9IAPICALL;7extOut ZA 96 35 "Testing 2* 9 

102 03l84 24 0AF0tAPIRE7:7extOut TRUE 

103 33 1 84240DD41 APICALL ;TextCut E4 37 35 "Testing 2" 9 

104 03 1 84241288 1 APXR£T:TextOut TRUE 

105 03l84 24155BlAPICALL:7extOut £4 35 96 "Testing 2" 3 
25 106 03l84241D70tAPIRE7:TextOut TRUE 

107 03 184242060 1 APICALL: TextCut £4 ?7 96 "Testing 2" 9 

108 33 I 84 242525 I APXRET :TextOut TRUE 

109 031 842427 F3 1 APICALL :TextOut ZA 35 37 -Testing 2" 9 

110 03(84 24 2CAClAPIRE7:TextOut TRUE 

111- 03 1 84 242F91 t APICALL: TextCut ZA 36 97 "Testing 2 m 9 

112 03l8424 923OIAPIRET:TextOuc TRUE 

113 33184 24 9571 1 APXCALL: TextCut ZA 97 97 "Testing 2" 3 

114 331 8424 9A96lAPXRET:TextOut TRUE 

115 031 84 249D6EJ APICALL; SetTextColor E4 FFFFFF 

116 03 1 8424A1E6 1 APXRET; SetTextColor 0 

35 117 031 84 2 4A57DI APICALL: Text Cut Z< 36 96 "Testing 2" 9 

118 03l6424AA39lAPIRET:TextOut TRUE 

119 03l8424AD19lAPICALL:£naPaint 3A {E4 FALSE (0 0 278 177} FALSE FALSE 17 1 IF 9A 8A 
0 FF FF 14 0 0 0 95 5 9E 9 ) 

120 03l8424C06AIAPXRET:£ndPaint 

121 02I84 24C2FC;MSGRET:0 0B3F0208 3A F-WM_?AINT 0 0 

122 . 01l8424C333lAPIRET:UbdateWinaow 

123 01 (8424CACB I APICALL: GetMessage 0 0 0 

124 02I842402A6IMSGCALL:OB3F020B 8A 3 4 -HM_NCHIT7EST 0 8700E7 

125 03IB424D63EIAPICALL:DefWlnaowProc 8A 9 4 -**M J4CHITTEST 0 8700E7 

126 33I84240AF"MAPIRET: DefWinaowproc 1 

127 02I84 24DE21IMSGRET: 1 OB3F0208 8A 8 4 -WM_NCH I TTEST 0 8700E7 

128 02!8424E7E6IMSGCALL:OB3F0208 9A 20-WM_S£TCURSOR 8A 2000001 
129. 331 8424ECTD I APICALL : OefWinaowProc 9A 20-WM_SETCURSOR 3A 2000001 

130 33l8424F7E9lAPXRET:OefWinaowProc 0 

131 02 1 8424 FB29 1 MSGRET: O OB3F0208 3A 20-WM_SE7CURSOR 8A 2000001 

132 01) 84 2501 D6 1 APIRE7: GetMessage TRUE (8A 200 0 5000E3 001C5B1F (E7 87} } 
50 133 31!8425080FlAPICALL:TransiateMessag« ( 8A 200 0 5D00E3 001CSB1F (£7 97) ) 

134 01 1 84250D97 1 APIRET : TranslateMessage FALSE 
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125 Oil 84 25137AJ APICAL!: OispatcnMeasaqe 8A 200 0 5DO0E3 001C5B1?.{E7 97) } 

126 02 ! 8 4 : 5 1 6A£ I MSGCALL : 083 F02 0 8 3A 200-WH_MOUScMOVE/WM_MOUScnSST 0 5000E3 

137 031 84 25lA8BlAPICAU.:DemnaowProc 3A 200-WMJ1C4JSEMOVE/WM_MOUSEFIRST 0 SD00E3 

138 03l84251ECS|API*ET:D«fWindovProc 0 

5 139 02184252100IMSGRET:0 0B3FO208 3A 200-WMJ10USEMOVE/WMJ10USE FIRST 0 5000E3 

140 0lJ84252SS0IAPIRET:OireatcftMessaqe 0 

141 01l842528BOtAPICALL;G«tMes8aqe 0 0 0 

142 02l84 3ia873lHSGCAU.:O83FO208 3A 34-WMJ*CHITTEST 0 3700E6 

143 03l8431CSC5IAPICAU.:D«fMlndoweroc 3A 34-WM_NCHITTEST 0 8700E6 
w U4 03l8431C383lAPIRET:DafWtnoowProc 1 

145 02)8431CEC0IKSGRET:1 0B3FO2O8 3A 34-WM_NCHIT7EST 0 3700E6 

146 02I84 31D5891MSGCALL;OB3F0208 8A 20-WM_5ETCURSOR 8A 2000001 

147 03l8431D9S9IAPICALL;D«fm.mlowProc 8A 20-WH_3ETCJRSOR 3A 2000001 
14 8 03 1 84 31DFA7 1 APIRET : DefWlndovProc 0 

14 9 02l84 31£2D3lMSGRET:0 0B3f0208 9A 20-WM_SETCURSOR 8A 20O0O01 

75 150 01l84 31E982lAJlRET:GetMesaaqe TRUE { 8A 200 0 5DOOE2 001C50E0 (E6 37 J ) 

151 0U8431EDB4 l APICALL:TranalateM«saaq« {8A 200 0 5000E2 001C5DEO (E6 37 1 j 

152 01l84 3irC20lAPIRET:TranalaceMeaaa<?« FALSE 

153 Oi l 84 31FFlElAPICALL;Oi«paccnMe3saqe *8A 200 0 5000E2 001CSCE0 (E6 37) } 
154- 02:843205F3mSCCALL:OB3F0208 iA 200-«M_MOUSEMOVE/WM_MOUSEF1RST 0 5000E2 

2Q -55 03l34 3209DF!APICALL;Oe£WinaowProc 3A 200-WM_MOUSEMCVE/WM_MOUSEnRST 0 5D00E2 

156 03l84320E18IAPIRET:OefWinaowProc 0 

157 02lB432I129tMSGRET:0 0B3FO208 9A 200-WM_MOUSEM0VE/WM - MOUSEFIRST 0 5D00E2 
153 01l84 3219D0lAPIRET:OlspatchMessaqe 0 

159 01l84321CFDIAPICALL:GetMeaaage 0 0 0 

160 02I84322475IMSGCALL:OB3F0208 3A 34-WM_NCHITTEST 0 3700E5 

25 -61 03 1 84 322914 I APICALL; Oef Window Proc 3A 34-WM_NCHITTEST 0 3700E5 

162 03l84322C9F1APIRET:0efWiivaowProc i 

163 02l84222ZFEiMSGR£T:l O83FO208 3A 34-MM_NCHI7TEST 0 37Q0E5 

164 02I84323C29IMSGCALL:OB3F0208 3A :0-WM_SETCURSOR 9A 2000001 

165 03l84 324 02DtAPrCALL:DefWln<lowProc 3A 20-WM_SETCURSOR 3A 2000001 

166 03l84 324 658lAPIRET:OefWlnaow?roc 0 

30 167 02184324984 I MSGRET : 0 OB3F0208 3A 20-WM_SETCJRSOR 3A 2000001 

168 01 1 843250D1 I APIRET :GetMessage TRUE {8A 200 0 5D00E1 001C50FE (E5 37] ) ???? 

169 01 1 84325808 t APICALL: TranslateMesaaqe ! 8A 200 0 SDOOEI 001C5DFE iE5 37} ) 

170 0il843ZSD8AIAPIRET:TransiateMessaqe TALSE 

171 01 1 84 32606C ; APICALL: OlapaccnMessaqe { 8A 200 0 5D00E1 001CS0FE (E5 87} } 
35 17 2 02l84326F02lMSGCALL:0B3F0208 3A 200-WH_MOUSEHOVE/WM_MOUSEnRST 0 5D00E1 

173 03i84327ZEDIAPICALL:OefWln<lovProc 3A 200^J4OUSEMOVE/WM_MOUS£FIRST 0 SDOOEI 

174 03l8432772DIAPIRET;OefHLnaowProc 0 

175 02I8432^A30IMSGRET:0 083F0208 3A 200-WM^MOUSEMOVE/WM_MOUSEFIRST 0 SDOOEI 

176 01l84 327E32lAPIRET:Dispatc.lMeasaqe 0 
17-7 01 1 8442369AlAPICALL;GctMeasaqe 0 0 0 

40 

178 01184 56DF3EIAPIRET:G«tMessaqe TRUE { 6A 100 10 360001 001C6508 i 12E 7F} ) 

179 0il8456E4O9(APICALL:TransiateM«aaaqe { 8A 100 10 360001 001C65D8 { 12E 7F) } 

180 0li8456ED61(APIRET:TranalateMesaaqe TRUE 

181 01l8456F0A2lAPICALL;OispatchMe3saqe <8A 100 10 360001 001C65D8 I 12E 7F} } 

182 02I8456FAOOIMSGCALL:OB3F0208 9A 100-WM_KEYDONN/WM_KEYFIRST 10 360001 

45 183 03l84 56FECAIAPICALL:0omtnaowProc 3A 1 00 -WM_KEYDOWN/WM_KEY FIRST 10 360001 

184 03|8457041C:APIRET:OefHtnaowProc 0 

135 0218457077AIMSGRET:0 0B3F0208 3A 1 00 -WM_.<EY DOWN /WMJCEY FIRST 10 360001 

186 01l84570BO3lAPIRET:OlspatchM*ssaqe 0 

187 01l84 57 0F03lAPICALL:GetMeasaqe 0 0 0 

188 Oil 84 59F38CIA?IRET:GotMeaaaqe TRUE (8A 100 48 230001 001C663C (12E 7p} } 
50 189 Oil 34 59F850)APICALL:TranalateM«asaqe ( 8A 100 48 230001 001C668C t 12E 7F) } 

190 Oil 94 5A013AI APIRET rTranal at eMesaage TRUE 
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191 01l845A0475iAP:CAXl;DispaccnMesaaqe iSA 100 4 8 230001 001C663C I12E 7FJ i 

192 O2l84 5AOB28lMSGCALi:0B3F02O8 3A 100-WM_XEY DOWN /WMJ<EY FIRST 48 230001 

193 03l8«SA0nBlAPICALL:Demnaoweroc 3A 100-WMJCE^DOWN/WMJ<EYFIRST 48 230001 

194 03l84SAl"CSlAPIRET:DefHlndavProc o 

5 195 02I845A1B50|MSGRET:0 0B3r0208 3A 1 0 0 - WM_KEY DOWN / WM_KEY FT RS7 48 230001 

196 01l84 5AlFBDlAPIRET:0i*patcnMessaqe 0 

197 01i845A22SClAPICALL;G«MMaage 0 0 0 

198 01|845A342AlAPIRET:G«*MMaaqe TRUE { 8A 102 48 230001 001C668C U2E 7FJ ) 

199 01l845A38D6lAPICAIX;TranalateMeaaaqe (8A 102 48 230001 001CS68C ( 12E 7FJ } 

200 01 1 84 5A3E00 1 API RET : TranalateMa-ssaqe FALSE 

10 201 01l845A41FllAPICALL;DijpatchMeaaaqe {8A 102 48 230001 001C663C [12E 7F) 1 

202 02|84SA48ABIMSGCAU.;GB3F0208 3A 102-WM_CHAR 48 230001 

203 03l845A4C8FlAPICALL;OefWlnaowProc 3A 102-WM_CHAR 48 230001 

204 03l84 5A50D2IAPIRET:DafHtnaowPrDC 0 

205 02I84SAS41AIMS J ,RET:0 0B3F0208 3A 102-WW_CHAR 48 230001 
75 206 01I845A580DIAPIRET:DlapaccftMeaaaqe 0 

207 01I84SA5B39lAPICAU.;GetMesaaqe 0 0 0 

208 01l84 5BAC-5IAPIRET;G«tMessage TRUE ( 3A 101 4 8 C0230001 001C66E6 (12E 7FJ | 

209 01l845BB104IAPICALi;TranslaceMessaqe 1 8A 101 48 CO230O01 001C35E6 i 12E 7F» j 

210 01l845BB9O9lAPIRET;TranslateMcssaqe TRUE 

211 01l845BBD14IA?rCALL;Dispatc.nMessaqe i 3A 101 48 C023OOO1 001C66ES U2E 7F) f 
20 212 02!84 5BC3F3IMS5CM.1:0B3F0208 3A 101-WMJ<EYUP 4 8 C0230001 

213 03I845BC304 1 APICALL; DefWlnaovProc 3A 101-«MJ<EYUP 48 C0230001 

214 031 84 5BcrA8lAPIRET:Oe£WinaowProc 0 

215 02|84 5BD32S!MSGRET:0 0B3F0208 3A 101-WMJCEYUP 4 8 C0230001 

216 01l84 5BD7 46lAPIRET:OiapatcftMea*aqe 0 

217 01l84 5BDA7AlAPICALL:G«tMesaaqe 0 0 0 

218 01l84 5D0A5ElAPIRET:GetMessaqe TRUE ! 8A 101 10 C0360001 001C67 21 { 12E 7FI 1 

219 01l34 5D0EC5lAP:CALL:Translate««ssaqe { 8A 101 10 C0360001 0O1C6731 [ ;2E 7") ) 

220 01J845D138aiA?IRE7:Tr3nsiate««ssaqe TRUE 
01IB4 5DlE3C:APICAL;.;0ispaccr.Messaqe ( 8A 101 10 CC360001 001C6731 ( 12E 7F1 ) 
02l84 5D24FSiMSGCALL;0B3FO2O8 SA L01-WMJ<EYUP 10 C0360001 

30 ZZ2 03l84 5028ADlAPICAL«:0efWlnaowProc 9A 101-WMJCEYUP 10 C036OO01 

224 03l84 503308lAPIRET:0«£WinaowProc 0 

225 02I845D36461MSGRET:0 0B3F0208 3A 101-WMJCEYUP 10 C0360001 

226 Oil 84SD3A0ElAPIRET:0ispatcnMeasaqe 0 

227 011845D3D04 l APICALL:GecMeasaqe 0 0 0 

228 01J845F5E5AIAPIRET:G«tMeasaqe TRUE ( 8A 100 45 120001 001C67A9 { 12E 7F1 } 
35 229 Oil B4SF62AFIAPICALL:TranalateMeaaaqe (8A 100 45 120001 001C67A9 { 12E 7FI } 

230 01l845F6338lAPIRET:TranalateHesaaqe TRUE 

231 01)84SF6E2EIAPICALL;01apatcnMesaaqe { 8A 100 45 120001 001C67A9 (12E 7F) } 

232 O21845r748BlMSGCAU.:0B3FO208 3A 1 00-WM_KEY DOWN/ WHJCEY FIRST 45 120001 

233 031 84 5r?87 3 I APICALL; DefWtnaowProc 3A iOO-WjCEYDOW/WHJCEY FIRST 45 120001 ■ 
4Q 224 03tB4 5F704 3lAP:RET:0«£WlnaowProc 0 

235 02I845F8061IMSCRET:0 OB3F0208 3A 100-WM_KEYDOWN/WH_JCEY FIRST 45 120001 

236 01l84SF84 48lAPIRET:OiapatchMessaqe 0 

237 01 184 5F87 38 1 API CALL: Get Message 0 0 0 

238 01 1 84 5F8D36I APIRET;GetMeaaaqe TRUE {8A 102 65 120001 001C67B8 {12E 7F| | 

239 01l845F913AlAPICALL:Transiate«e3aaqe (8A 102 65 120001 001C6788 ( 12E 7F) ) 
45 240 01l845F?6B0IAPIRET:TranaiateMesaaq« FALSE 

241 01l84 5F9990lAPICALL:0iapaccnMeaaaqe (8A 102 65 120001 001C67B8 (12E 7F) J 

242 02|84 5F3GAFIMSGCALL;QB3F0208 3A 102-WM_CHAR 65 120001 

243 03l845F347DIAPICALL;0«fWlndovProc 3A 102-WM_CHAR 65 120001 

244 03) 84 5F3868lAPIRET:0efWlr*dawProc 0 

245 02I845F3B8C;MSGRE7:0 OB3F0208 3A 102-WM CHAR 65 120001 
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246 01l84SF3F:riAPIRET:Di»patcr^1eaaaqe 0 
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247 01 1 84 5FC2IC; APICALL :GetMessage 3 0 6 

248 01 1 846CES31 ! APIRET:GetMessage TRUE ( 8A 101 45 C0120001 001C6303 { 12E "Fl \ 

249 01 l84 60E999lAPICALL;7ranslate«easage i 8A 101 AS C0120001 001C6803 {12E 7F1 

250 01 l8460F4 36lAPIRET:TransiateMe3aage TRUE 

251 Oil 8460F7 37 I APICALL; OispatcnMessage { 8A 101 45 C012OOO1 0O1C63O3 ( 12E 7F} J 

252 02I84 6OFE34IMSGCAIX.-0B3FO2O8 3A 101-«M_KEYUP . 45 C012O0O1 

253 031 34 6101EE1 APICALL: Da fWlndevProc 9A 101-WMJCEYUP 4 5 C0120001 

254 031 84610841 iAPIRET: Do fWlnaovProc 0 

255 021 84 610B7DIMSGRET:0 0B3F0208 3A 101-WMJCEYUP 4 5 CO 12 0001 

256 Oil 8461 0F3C;APIRET:0ispatcnMessage 0 
10 257 01 1 84611231 I APICALL :G«tMessage 0 0 0 

258 01 1 946513E3 I APIRETrGetMesaage TRUE { 3A 100 4C 260001 001C68E4 1 12E 7FJ ) 

259 01 l84 6513DC;APICALL:?ranjlateMe»sage (8A 100 4C 260001 001C68E4 ( 12E 7F) } 

260 Oil 8465217 4 lAPIRET:Tf anslaceMessage TRUE 

261 Oil 846524 6AI " °ICALL: OispatcnMesaage (8A 100 4C 260001 001C68E4 {12E 7FJ J 

262 02t84652ADl|MSGCALL;083F0208 8A 100-WM J<FT DOWN/ WM_<EY FIRST AC 260001 

263 03l84 652£a9lAPICAU.:0efWtr*dovProc 8A iOO-WM_<EYDOWN/WM_KEY FIRST 4C 260001 

264 031 8465338D1APIRET: OefWtnaowProc 0 

265 02I846S36A9IMSGRET:0 OB3F0208 *A 1 00 -WMJ<EYDOWN/WM_KEY FIRST 4C 260001 

266 01 1346S3A91 1 APIRET : OiJpaccnMessage 0 

267 Oil 34 653D82 1 APICALL: Cetrtessage 3 0 0 

20 - 6a Oil 346543931 APIRE7:GetMessage TRUE { 8A 102 SC 260001 001C6BF3 {12E 7F] J 

269 Oil e4654 7?6*APICAXJ.:TranslaceMessage { 8A 102 SC 260001 001C68F3 { 12E *?r} } 

270 01 |84 654 00C:APIRET:TranalaceMessagc FALSE 

271 01 1 84654 FECI APICALL: OlapatcnMessage 1 8A 102 SC 260001 001C68F3 I12E 7F} } 

272 02 I 84 655604 1MSGCALL;0B3 F02 08 3A I02-WM_CHAR SC 260001 

273 031 84655978 1 APICALL: 0**WinaowProc 3A 102-WH_CHAR SC 260001 
25 27 4 03|846570A4lAPIRE?:0«fHindowProc 0 

27 5 02|84 657 3O4IMSGRE7;0 OB3F0208 iA 102-WM_CHAR 6C 260001 

276 01 l846577SAlAPIRET:DIspatcnM*ssage 3 

277 01 1 34 657A7 01 APICALL; GetMessage 0 0 3 

278 01 I 84 661F63 I APIRET:Se^Message TRUE ( 8A 101 4C C0260001 001C6320 \ iZZ ~T) \ 
20 27*9 01 1 846o23B6i APICALL: TransiaceMessage { 8A 101 4C Z0250O01 001C6920 1 12E ~?) 

230 01 1 34662362 : APIRE7:TranslateMessage TRUE 

231 01 1 34 663E6E i APICALL : OlspatenMessage {8A 101 4C C0260001 001C6920 (12E t?) ) 
282 02l34664 73OlMSGCALL:0B3F0203 3A 101-WM_KEYUP 4C C02 60001 

233 031 34 6S4B3E I APICALL: DetWlnaowProc 3A 101-WM_<EYUP 4C C02 60001 

234 03t 846651D1 IAPIRET:OefWlnaovProc 0 

35 285 021 34665509 1MSGRE7:0 0B3F0203 3A 101-HMJCEYUP 4C C0260001 

236 01 1 946658C7 IAPIRET:OispaccnMes«age 0 

237 01l84 665BBOlAPICALL:GecMessag« 0 0 0 

288 01 1 84 67 3FD01 APIRE7:GetMtfsaage TRUE (8A 100 4C 260001 001C6963 (12E 7F) I 

289 Oil 8467 9422 I APICALL; TransiateMessage ( 8A 100 4C 260001 001C696B { 12E 7FJ J 
^ 290 Oil 84 679F30tAPIRET:TransiateMessag« TRUE 

291 01 1 8 4 67 A23F I APICALL; DispatchMessage {OA 100 4C 260001 001C6963 (12E 7F} ( 

292 02I8467A8A£lMSGCALL;0B3F02O8 3A 100-HMJCEYDOKN/WHJCEYFIRST 4C 260001 

293 03IB4 67AC99IAPICALL:0efWlnaowproc 8A 1 0 0-WM_K£Y DOWN / WM_KEY FIRST 4C 260001 

294 03 184678163 1 APIRET:OsfWlndovProc 0 

295 02|84673483IMSGRE7:0 OB3F0208 8A 1 00 -WM_KEY DOWN /WMJCEY FIRST 4C 260001 
45 296 01l6467B868IAPIRE7:Oi5paccnHessage 0 

297 01 1 84 67BBS7 I APICALL :G«tMessage 0 0 0 

298 01l84 67cl6ElAPrRE7:G«Me«age TRUE 1 8A 102 6C 260001 001C697A { 12E 7F| ) 

299 01l8467C«7 3lAPICALL:TranslateMesaage ( 8A 102 6C 260001 001C697A il2E 7F) ) 

300 01 1 3467CA£CtAPIRET:TranslaceMessage FALSE 

50 301 01 1 84 67 C2C3 1 APICALL: OlspatcnMessaqe { 8A 102 SC 260001 001C697A (12E T FJ 1 

302 02I84S7E95C;MSGCALL:OB3F0203 9A 1C2-WM CHAR 6C 260001 
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203 03l34 67ED04lAPICALL:DefWindovPrDC 3A 102-WM_CHAA 6C :60001 - 

204 03l84 67F0F3lAPIRET;0eiWlndovProc 0 

205 02l8467F403lMSGRET:0 0B3r0208 3A i02-WM_CHAR 6C 260001 

206 01l94 67F7 9FlAPIRET;0iapatcftM«88ago 0 

5 307 01l8467FA8C:APICALL:GecMes3age 0 0 0 

308 01 1 84 68BE51 1 API&ET:GetMesaage TRUE t BA 101 4C C0260001 001C69B6 {12E 7FJ J 

209 Oil e4 68C29DlAPICALL:Tranalat«M«aaage (8A 101 4C C0260001 001C69B6 (12E T) ) 

310 Oil 8463CAS2IAPIRET:TranalateM«3Sage TRUE 

311 01l84 68CD4 9lAPICALL:OispatcftMe3sage | 8 A 101 4C C0260001 001C69B6 ( 12E 7F1 } 
70 212 02l84 6806E5iMSGCALl:OB3F0208 8A 101-«M_KEYUP 4C C026OOO1 

313 03l84 63DAB9IAPICAIA:OefWlnaovProc 3A 101-WMJCEYUP 4C C0260001 

214 03l846aE10C:APIRET:0«fWlnaowProc 0 

215 02!8468E4 43IMSGRET:0 0B3FO208 3A 101-WMJCEYUP 4C C026OOO1 

216 01IS46a£8AClAPIRET:0i5pacc.»iMessage 0 
317 0U8463EBA6lAPICALL:G«tM«33age 0 0 0 

15 318 01l846A7 98FIArIRET:GetMeaaage TRUE {8A ioo 4F 180001 001C6A10 1 12E 7FJ } 

319 01l84 6A7DC9lAPICALL:?ranaiateMesaage ( 8A 100 4F 180001 001C6A10 (12E T) ) 

320 01l84 6A863CIAPIRET:TranalateMessage TRUE 

321 Oil 84 6AB932:APICALL:Di3paccnMe33aqe ( 8A 100 4F 180001 001C6A10 {12E 7F> i 
2tZ 02:84 6A906EiMSGCALL;0B3F0208 3A 1 00 -WM_KEY DOWN /WM_:<EY FIRST 4F 180001 

2Q 223 03184 6A94 3BIAPICALL:OefWinaovProc 3A 100-«M_KEY DOWN /WM__KEY FIRST AT 180001 

224 03t94 6A98F6lAPIRET:0cfHindowProc 0 

225 021B46A9C:2!MSGRET:0 OB3F0208 3A 1 00 -WJCEYDOWN/WMJCEY FIRST 4F 180001 

226 01i84 6A9Fr2lA?IRET:DispatcnMes3age 0 

227 01l84 6AA2£2lAPICALL;GecMessage 0 0 0 

228 01 1 84 6AACAB1 APIRET:GetMeasage TRUE { 8A 102 SF 180001 001C6A10 { 12E 7F1 i 

229 01i84 6AB0C£lA?:CALL;TranalatBrteaaage (8A 102 6F 180001 001C6A10 { 12E 7Fj > 

230 01l84 6AB63FIAP:RET:Tranalat9Measag« FALSE 

231 01 1846AB91DI APICAL! ; DispatchMeasage { BA 102 6F 180001 001C6A10 { IZZ "F; ■ 

232 02! 94 6ABF48IMSGCALL:OB3F0208 3A 102-WMJSiAR 6F 180001 

333 03IB4 6AC64 2IA?ICALL:0efWlnaowProc 3A 102-WH_CHAR 6F 190001 

30 234 03ia4 6ACA3l:A?IRr::0efWinaowProc 0 

335 02!34 6ACD3C:MSGRET:0 0B3F0208 3A 102-WM_CHAR oF 130001 

236 Dll34 6A0160lA?IRET:01spatcnMessage 0 

237 0H 34 6AD460lAP:CALL:G«tM«aaagc 0 0 0 

238 0H3463BE04 IA?IRET:GctMessage TRUE 1 8A 101 4F C0180001 001C6A58 (12E ~??) ) 

239 Oil 846BC24 El APICAL! ;Tr ana la teMeasage { 8A 101 4F C0180001 001C6A5B {12E "Fl I 
35 240 Oil 84 6BC9C1 JAPIRET:TranslateMessage TRUE 

341 01l846BCC36tAPICALL:0l3pacchM9ssage (8A 101 4F C0180001 O01C6A5B {12E *D ) 

342 02IB4 6BD2FC;mSGCALL;OB3F0208 3A 101-«M_KEYUP 4F C01 80001 

343 03lB4 6BD69ElAPICALL:DefWlndowProc 8A 101-WM_KEYUP 4F C0180001 

344 03l84 6aDCC5IA?IRET:D«fWlndowProc 0 

^ 345 02)84 6aDFF0lMSGRET:0 OB3F0208 3A 101-WMJCEYUP 4F C01 80001 

346 01l846BE3B6lAPXRET:01spatcftMeasage 0 

347 01 1 B4 63E6AD1 APICALL:GetMeaaage 0 0 0 

348 01l84B5206DIA?IRET:GetMeaaage TRUE {8A 104 12 20380001 001C6FCE { 12E *F> ) 

349 01|848524E0lAPICALL:?ranslateHeasage (8A 104 12 20380001 001C6FCE { 12E ?F| } 

350 Oil 84852CEaiAPIRET:TranslateM«aaagB TRUE 

45 35i 01l84852FE3IAPICALL:01spatcnMes8aga { BA 104 12 20380001 001C6FCE { 12E 7F) ) 

252 02IB4 85365BIMSGCALL:083F0208 3A 104-WM_SYSKEYDOWN 12 20380001 

353 03l84 853A2EJAPICALL:OafHindowProc 8A 104-WM_SYSKEYDOWN 12 20380001 

354 03i84 8540BDIA?IRET:D*fWlndovProc 0 

355 02|84 854 3FC1MSGRET:0 OB3F0208 3A 104-i*l_SYSKEYDOWN 12 20380001 
50 256 01l34 854 7D6lAPIRET:DispatcnMeaaage 0 

257 01l84854AC3IAPICALL:G«CMeaaag« 0 0 0 

258 Ol;34 8B8CC5iA?IRET:GetMeaaage TRUE i 3A 104 7 3 203E0001 001C7127 ( 12E ~F) \ 
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359 01l848B9123IAPICAlL:Tranalatef-e33age { 8A 104 ~3 203EOOO1 001C7127 [IZZ ?F] J 
260 01l84889CniAPIRE7:TranaiateMeaaage TRUE 

361 01l848BA22FIAPICALL;0iapatcnMeaaage {8A 104 73 203E0OO1 001C7127 U2£ 7rj ) 

362 02l848BA907iMSGCALL;0B3F0208 9A 104-WM_SYSKEYDOWN 7 3 203E000l" 

363 03l848BAT3FIAPICALL:0emnaowProc 3A 104-WM_SYSKEY0OWN 73 203EQ001 

364 03l848BB930lAPIRET:0«fWinaovProc 0 

365 02!848BBC6C;MSGRET:O 0B3F0208 9A 104 -WM_SYSKEY DOWN 73 203E0O01 

366 01IB48BC065lAPIRET:Oisp«tchMeaaage 0 

367 01l84 8BC35BlAPICAU.:G«tMeaaage 0 0 0 

10 ^68 01t648BC944(APIRET:G»tMeaa*qe TRUE { 8A 112 F060 0 001C7136 { 12E 7FJ J 

369 01l84 8BCD4 9lAPICAU.;TranalateMe83ag« {8A 112 F060 0 0O1C7136 (12E 7rj J 

370 01l848BD2B2lAPIRET:TranslaeeMeaaage FALSE 

371 01l848BD591IAPICAIi:0ispatcftMeaaage (8A U2 F060 0 001C7136 (12E 7F1 } 

372 02I848BEEC41MSGCALL;083F0208 8A 112-WM_SYSCCMMAND F060 0 

373 031 848BFS74 IAVICALL: OefWlndovProc 8A U2-«M_SYSC0MMAND FO60 0 
75 374 04I848BFD1FIMSGCALL:OB3F0208 3A 10-WM_CLOSE 0 0 

375 05l84 8C0065lAPICALL:0«fWindowProc 3A 10-«M_CU>SE 0 0 

376 06I84 8C086BIKSGCALL;OB3F0208 3A 4 6-WM_WINOOWPOSCKANCING 0 C370180 

377 07|848C0C20tAPICALI.;0efHlnoowProc 3A 4 6-WM_WTNDOWPOSCrfANGING 0 C370180 
37 ff 071 848Ci0DF!APIR£T:DefWlnaavProc 0 

379 06I848C140EIMSCRET:0 083F0208 3A 4 6-WM_WIN0OWPOSCHANG:nG 0 C370180 

380 06I84 8C2EE3IMSGCAU.;0B3F0208 3A 47^ jJi ND0 WPOSCHANGED 0 C37Q180 

381 07|848C32DC!APICALL:OefWinaowProc 3A 4 7-WMJWINDCWPOSCHANGED 0 C27018O 

382 07i848C37AllAPIRET:OefHlndowProc 0 

283 06l848C3E3BlMSCRET:0 0B3F0208 3A 4 7-«M_HINOOWPOSCHANGED 0 C370180 

384 06l848D755EiMSGCAU.;0B3F0208 3A 36-WM_NCAC7rVATE 0 0 

385 07)848O7 96UAPICALL;De£HinoowProc 3A 6 6-WMJMCACTIVATE 0 0 

386 07 l848D80E3lAPIRET:D«fWlnaowProc 1 

387 06I848D84iOIMSGRET:l 0B3F0208 3A 36-WM_NCAC7:VATS 0 3 

388 06I848D89AC:MSGCAZ.L:0B3F0208 9A 6 - WM_AC7 IYATE 0 0 0 

389 07i84808D13IAPICALL:DetWlnaowProc 9A o-WM^ACTIVATE 0 3 0 

290 07l848D9162!APIRET:DetWlnoowProc 0 

291 06l848O94 7aiMSGRET:0 0B3F0208 3A 6-WM_AC7:YATE 0 0 0 

292 06I848D9AC3ISSGCALL:OB3F0208 3A 1C-WM_AC7:VATEAPP 0 3 0 

393 07l84809E54tAPICALL:0efWlrwowProc 3A 1C-WM_AC7IVATEA?? 3 0 0 

394 07|848DA22F!APIRET:De«Un<SovProc 0 

395 06I8480AS33IMSGRET:0 0B3F0208 3A IC-WH_ACT:7ATEAPP 0 0 0 
35 396 06t848DAB85lMSGCALL:OB3F0208 8A 8-WMJttLLFOCUS 0 0 

397 07|848DA£CEIAPICALL;Oc£WtnaowProc 8A 9-WM_KILLFOCJS 0 0 

398 07(848DB26FIAPIRET:OefWtnaowProc 0 

399 06I848D8576IMSGRET:0 OB3F0208 3A 3-WHJCILLFOCUS 0 0 

400 06I848DBB1£IMSGCAIX;OB3F0208 3A 2-WM_DESTROY 0 0 

401 07|B48D8E46iAPICALL:PostQuitMes»age 0" 
40 402 07|848DD880lAPIRET:PoatQuitMesaage 

403 06I848DDDBBIMSGR£T:0 0B3F0208 9A 2-WM_DESTROY 0 0 

404 06I8480E802IMSGCALL;OB3F0208 9A 92-wTnCDESTROY 0 0 

405 07i848DEB60IAPICALL;(&fWtnaovProc 8A 82-WM_NCDESTROY 3 0 

406 07!848DF6261APlRET:OofWlndowProc 0 

45 407 06|848EOEE2IMSGRET:0 OB3F0208 9A 82-WM_NCDESTROY 0 0 

408 0S!848E4690lAPIRET:0«fWlndowProc 0 

409 04I848E4 9ESIMSGRET:0 0B3F0208 9A 10-WMJTLOSE 0 0 

410 03l84 8E5237tAPIRET:0«fHlndowProc 0 

411 02I848E5£82IMSGRET:0 0B3F0208 9A U2-WM_SYSCCMMAND ?060 0 

412 01(848E596B(APIRET:OispatchMeasag« 0 
50 413 0ll84 8E5C6llAPICAIX:GctMes»age 0 0 0 

414 01l848E62:C:AP:RET:G«tMeaaago FALSE {0 12 0 0 OOlCTir; {12E 7Ft J 



55 The Synthetic GUI Application 

Once a log file for the execution of an application program is generated, the execution of the application 
program can be simulated on a new op rating system. The synthetic GUI application (SGA) program reads 
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in the log file and simulates the recorded behavior by invoking the functions of the new operating system or 
some other existing operating system. By simulating the behavior of the application program, the new 
operating system can be tested to ensure its functions perform correctly. 

The SGA program provides a thunk function for every real function of the old operating system. The 

5 thunk function simulates the execution of the real function on the new operating system by invoking the 
functions of the new operating system. If the new operating system has a function whose behavior 
corresponds to the behavior of the function of the old operating system, then the thunk function can use the 
function of the new operating system to simulate the behavior. However, if there is no corresponding 
function of the new operating system, then the thunk function may have to invoke several functions of the 

70 new operating system to simulate the behavior. 

Each thunk function that corresponds to a real function, that is passed a callback routine, provides a 
thunk callback routine. The thunk callback routine simulates the behavior of the corresponding real callback 
routine in the application program. Each thunk callback routine, when invoked by the new operating system, 
invokes an SGAEngine routine, as described below, to simulate the behavior of the application program. 

75 Figure 10A is an overview diagram illustrating the synthetic GUI application (SGA), The SGA 1010 
comprises the SGAEngine routine 1050, thunk functions 1060 for each real function of the old operating 
system, and thunk callback routines 1070 corresponding to real callback routines of the new operating 
system. The new operating system 1020 comprises real functions 1030 and a window class table 1014. The 
SGA 1010 reads the log file , and simulates the execution of the recorded application program. Each 

20 recorded invocation of a function is simulated by invoking the corresponding thunk function with the 
recorded passed parameter(s). The behavior of each invocation of a callback routine is simulated by a thunk 
callback routine. 

The SGAEngine routine 1050 controls the simulation. The routine is passed a message and simulates 
the execution of that message. The routine scans the log file for the invocation of a callback routine through 

25 which the message is sent to the application. The routine then simulates the execution of each invocation of 
a function that is nested within that callback routine. For example, if the SGAEngine routine is invoked for 

the message WM CREATE corresponding to line 20, then the routine simulates the nested invocation of 

the function DefWindowProc at line 21 . The SGAEngine routine retrieves the passed parameters from the 
log file and invokes functions of the new operating system to simulate the behavior of the function of the old 

30 operating system. When the function of the new operating system is complete, the SGAEngine routine 
determines whether the returned parameters compare to the logged returned parameter. If the parameters 
do not compare, then the difference is noted. Optionally, timing information about the invocation on the new 
operating system can be recorded in a separate new log file. 

Figure 1 0B is a flow diagram of the synthetic GUI application program. The synthetic GUI application 

35 (SGA) inputs a log file and simulates the execution of the GUI application program recorded in the log file 
by invoking functions of a new operating system. In step 1001, the SGA generates a sent message file 
(SMF). The sent message file contains an entry for each sent message recorded in the log file. Each entry 
in the sent message file contains an identifier of the message, the line number of the message in the log 
file, and a handle identifying the resource (e.g., window, dialog box) to which the message is directed. Table 

40 3 is a sample sent message file generated for the log file of Table 2. Line number 5 of the sent messag 

file contains the entry "WM CREATE 20, 8A", which indicates that line number 20 of the log file records 

that a WM CREATE was sent to the window with handle 8A. In step 1002, the SGA generates a posted 

message file (PMF). The posted message file contains an entry for each posted message recorded in the 
log file. Each entry in the posted message file contains the message name, the line number corresponding 

45 to the retrieval of the message, the line number where the event corresponding to the posted message 
should be simulated, and a handle identifying the resource (e.g., window, dialog box) to which the message 
is directed. Table 4 contains a sample posted message file for the log file of Table 2. Line number 5 in the 
posted message file contains the entry "WM_ KEYDOWN 192, 187, 8A", which indicates that line number 
192 in the log file records at a WM KEYDOWN message was retrieved by the window procedure for the 

so window with handle 8A and that the posting of the message should be simulated at line 187. Alternatively, a 
sent message file and a posted message file is generated by the logger during the ex cution of the 
application program. In step 1003, the SGA invokes a SGAEngine routine to simulate execution of the 
application program. 

55 
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TABLE 3 
SENT MESSAGE FILE 

1 0,8A 

2 WMJ5ETMINMAXINF0 8,8A 

3 WMJJC CREATE 12 , 8A 

4 WMJ(CCALCSIZE 16,' 8A 

5 WM^CREATE 20, 8A 

6 WM^SHOWWINDOW 2 6 , 8A 

7 WM~WINDOWPOSCHANGING 3 0 , 8A 
3 WM_QUERYNEWPALETTE 34 , 8A 

9 WMJflNDOWPOS CHANGING 38, 8A 

10 WM_AC7IVATEAPP 40 ,8A 

11 WM_NCACTIVATE 4 6, 8A 

12 WMJ5ETTEXT 4 8, 3A 

13 WM"AC7IVATE 54, 8 A 

14 WM_SETF0CU5 56, 8A 

15 WMJ/CPAINT 67 [ 8A 

16 WMJ3ETTEXT 64, 3A 

17 WM~ERAS E3KGND 70, 3 A 

18 WM~WINDOWPOSCHANGED 74^ 

19 WKSIZE 78, 3A 

20 WMJ40VE 32, 3A 

21 WM~PAINT 88 ' 8a 

22 WM_MCHIT7EST 126, 8A 

23 WM_SET CURSOR 130, 3A 

24 wTVlOUSEMOVE 138, 8A 

25 WM JICHI TTEST 144 ^8A 

26 WM^SET CURSOR 148* 8A 

27 WM~MOUSEMOVE 156^ 3A 

28 WMJfCHITTEST 162^ 

29 WM_SETCURSOR 166, 8 A 

30 WM_MOUSEMOVE 174, 3A 

31 WM_KEYDOWN 184^ 

32 WMJCEYDOWN 194 ^8A 

33 WM~CHAR 204 ' 8A 

34 WMJCEYUP 2 X4 ! 8A 

35 WMJCEYUP 224! 8A 

36 WMJCEYDOWN 234, 8 A 

37 WMJTHAR 244 ^8A 

38 WMJCEYUP 254^ 8A 

39 WMJCEYDOWN 2 64 ! 8A 

40 WMJTHAR 274 !sa 

41 WMJCEYUP 284, 8A 

42 WMJCEYDOWN 294, 8 A 

43 WM~CHAR 304 !aA 

44 WMJCEYUP 314, 8A 

45 WM~KEYDOWN 324, 8A 

46 wfcHAR 334, 8A 

47 WMJCEYUP 344, 8A 

48 WM_SYSKEYDOWN 354, 8A 

49 WM_S YS KEYDOWN 364, 8A 

50 WM~SYSCOMMAND 374, 8A 

51 WlTcLOSE 376, 8A 

52 WMJJINDOWPOSCHANGING 378, 8A 
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53 


WM_WINDOWPOSCHANGED 


382, 3A 


54 


WM_NCACTIVATE 


386,8A 


55 


WM_AC7IVATE 


390, 8A 


56 


WM_ACT IVATEAP P 


394 ,8A 


57 


WMJCILLFOCUS 


398.8A 


58 


WMJDESTROY 


402, 8A 


59 


WMJJCDESTROY 


406, 8A 



TABLE 4 



POSTED MESSAGE FILE1 




WM MOUSEMOVE 

» » IVI | VI \J \J %j E_ 1 VI \s V L— 


1 1 ftA 


2 


WM_MOUSEMOVE 


154,1 41 ,8A 


3 


WM_MOUSEMOVE 


172,159,8A 


4 


WM KEYDOWN 


182.177.8A 


5 


WM KEYDOWN 


192,187 ( 8A 


6 


WM CHAR 


202,1 97,8A 


7 


WM_KEYUP 


212,207,8A 


8 


WM KEYUP 


222,21 7.8A 


9 


WM KEYDOWN 


232.227.8A 


10 


WM CHAR 


242.237.8A 


11 


WM_KEYUP 


252,247,8A 


12 


WM KEYDOWN 


262.257.8A 


13 


WM CHAR 


272 ( 267,8A 


14 


WM_KEYUP 


282.277.8A 


15 


WM KEYDOWN 


292,287,8A 


16 


WM CHAR 


302.297.8A 


17 


WM_KEYUP 


312.307.8A 


18 


WM KEYDOWN 


322,31 7,8A 


19 


WM CHAR 


332.327.8A 


20 


WM_KEYUP 


342,337,8A 


21 


WM SYS KEYDOWN 


352,347,8A 


22 


WM__SYS KEYDOWN 


362,357,8A 


23 


WM SYSCOMMAND 


372,367,8A 



Figure 11 is a flow diagram of the routine GenerateSentMessageFile. The sent message file is 
generated to improve the processing efficiency of the SGAEngine routine. In step 1101, the routine writes 
an initialization message (INIT) to the sent message file. This initialization message is used as an indication 
to initialize the SGAEngine routine. In steps 1102 through 1105, the routine loops searching for invocations 
of a callback routine and writes entries to the sent message file. In step 1102, the routine searches the log 
file for the next entry corresponding to the invocation of a callback routine. In step 1103, if the end of the 
log file is reached, then the routine returns, else the routine continues at step 1104. In step 1104, the 
routine writes the message, the line number of the entry, and the handle of the resource to which the 
message is directed to the sent message file and loops to step 1 101 . 

Figure 12 is a flow diagram of the routine GeneratePostedMessageFile. This routine searches the log 
file for each posted message and determines when the posted message should be simulated by the SGA. 
In step 1201, the routine searches for the next invocation of the function GetMessage, which retrieves 
posted messages in the log file, or function PeekMessage, which looks at posted messages and may or 
may not retrieve them. In step 1202, if the end of the log file is reached, then the routine returns, else the 
routine continues at step 1203. In step 1203, the routine records the line number in the log file 
corresponding to the invocation of the function GetMessage or PeekMessage. This lin number indicates 
the point at which the event corresponding to the posted message should be simulated. For example, if the 

posted message is WM KEYDOWN , th n the WM KEYDOWN message should be simulated before the 

SGA simulat s the execution of the function GetMessage that retrieves the WM_KEYDOWN message or 
before the execution of the function PeekMessage, which may or may not have noticed its presence in the 
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message queue. In step 1204, the routine searches the log file for an entry corresponding to the invocation 
of a callback routine that matches the posted message. That is, the invocation of the callback routine 
through which the posted message was sent to the application program. In step 1205, the routine records 
the line number of the entry in ihe log file corresponding to the invocation of the callback routine. In step 

5 1206, the routine writes the message, message line number, post line number, and the handle of the 
resource to which the message is directed to the posted message file and loops to step 1201. In an 
alternate embodiment, the sent message and posted message files are generated during a single pass of 
the log file. Also, the sent message and posted message files need not be generated, rather the information 
can be determined from the log file as the simulation proceeds. 

w Figure 13 is a flow diagram of the SGAEngine routine. This routine is passed a window handle and a 
message. The routine simulates the application program processing of that message as recorded in the log 
file. The routine determines which entry in the log file corresponds to the passed message. In a preferred 
embodiment, this determination selects the first entry in the log file of a message of the same type as the 
passed message and with the same handle to a resource. The routine then simulates the execution of the 

75 application program that occurs in response to the receipt of the message. The execution that occurs in 
response is represented by the entries in the log file that are nested within the invocation of the callback 
routine that processes the message. The. SGAEngine routine is called recursively to process nested 
messages. To initiate the SGAEngine routine, a dummy entry is stored at line number 0 in the log file at 
nesting level tf and corresponding to the sending of the message INIT. The SGAEngine routine simulates 

20 execution of all entries in the log file nested within nesting level 0, which is the entire log file. In step 1301, 
the routine finds the message in the sent message file that corresponds to the passed message and 
records that message line. In step 1302, the routine determines the nesting level of the found message. In 
step 1303, the routine validates the passed parameters. In step 1304, the routine searches for the next line 
in the log file that corresponds to an invocation of a function within the callback routine that processed the 

25 passed message. The routine records that line number as the call line. For example, if the passed message 
corresponds to the message at line number 8 of the log file, then line number 9 contains a nested function 
invocation. In step 1305, if the routine finds a next line, then the routine continues at step 1306, else the 
routine continues at step 1310. In step 1306, the routine invokes routine SimulatePostedMessage to 
simulate the posting of a message, if appropriate. In step 1307, the routine finds the line corresponding to 

30 the return of the nested function invocation. In step 1308, the routine retrieves or identifies the thunk 
function for the nested function. In step 1309, the routine invokes the thunk function and loops to step 1304. 
In step 1310, the routine finds the return line associated with the invocation line of the message found in 
step 1301. In step 1311, the routine sets the appropriate return values and returns. 

Figure 14 is a flow diagram of the routine FindMessagelnSentMessageFile. This routine is passed a 

35 message and a resource (window) handle. This routine finds the next message in the sent message file that 
corresponds to the passed message for the passed resource handle. The routine returns the line number in 
the log file of the message. The routine maintains an array to track the last entry in the sent message file 
found for each message type for each resource handle. The routine starts the search from the last entry. In 
step 1401, the routine retrieves the message line of the last message found in the sent message file for the 

40 passed resource handle of the passed message type. In steps 1402 through 1403, the routine loops 
searching the sent message file for the next message of the passed message type for the passed resource 
handle. In step 1402, the routine increments the message line. In step 1403. if the message of the message 
line in the sent message file equals the passed message type and passed resource handle, then the routine 
continues at step 1404, else the routine loops to step 1402. In step 1404, the routine sets the last message 

45 line number for the passed message type and passed resource handle to the message line. In step 1405, 
the routine retrieves the line number in the log file of the entry corresponding to the invocation of the 
callback routine to process the passed message and returns. 

Figure 15 is a flow diagram of the routine SimulatePostedMessage. This routine scans the posted 
message file to determine if the posting of a message should be simulated before the SGA simulates the 

so execution of the function corresponding to the entry in the log file at the passed line number. The routine 
then simulates the posting of the message, if appropriate. In step 1501, the routine scans the posted 
message file to determine whether a message should be posted before simulation of the entry at the 
passed line number in the log file. In step 1502, if a message should be posted, the routine continues at 
step 1503, else the routine returns. In step 1503 through 1510, the routine determines which message 

55 should be posted and calls the appropriate routine to simulate the posting of the message and the routine 
then returns. 

Figur 16 is a flow diagram of a routine that simulates the posting of the WM__KEYDOWN message. 
The routine is passed the sent line corresponding to the invocation of the callback routine and the post line 
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number corresponding to the line number before which the message should be posted. In step 1601, the 
routine retrieves the message at sent line from the log file. In step 1602, the routine calls the function 

PostMessage or the new operating system or its equival nt to post the retrieved WM KEYDOWN message 

and the routine returns. 

5 Figure 17 is a flow diagram of a routine that simulates a WM_MOUSEMOVE message. The routine is 
passed the sent line number in the log file of the entry corresponding to the invocation of the callback 
routine and the post line number corresponding to the line number before which the posting of the message 
should be simulated. To simulate a WM_MOUSEMOVE message, the routine simulates the sent messages 
that were sent during the invocation of the function GetMessage that retrieved the posted 

to WM_MOUSEMOVE message. The routine then posts the WM_Jv10USEMOVE message to the new 
operating system. For example, line number 136 of the log file corresponds to the sending of a 
WM_MOUSEMOVE message and line number 123 corresponds to the line before which the posting of the 
WM_MOUSEMOVE message should be simulated. To simulate the WM_MOUSEMOVE message, the 
sending of the WM NCHITTEST message at line 124 and the sending of the WM__SETCURSOR message 

75 at line 128 should be simulated. This routine uses the function SendMessage (or its equivalent) in the new 
operating system to send these messages. The thunk callback routines are then invoked by the new 
operating system to send the message to the SGA. After the messages are sent, then the SGA posts the 
WM_MOUSEMOVE message by invoking the function PostMessage (or its equivalent) in the new 
operating system. In steps 1701 through 1704, the routine retrieves each sent message and sends the 

20 message to the new operating system. In step 1701, the routine sets the start of the search at the post line. 
In step 1702, if the search line in the log file indicates the return from the invocation of the function 
GetMessage at the post line, then the routine continues at step 1705, else the routine continues at step 
1703. In step 1703, the routine retrieves the next sent message from the log file. In step 1704, the routine 
calls the function SendMessage of the new operating system with the retrieved message and loops to step 

25 1702. In step 1705, the routine retrieves the message corresponding to the return from the invocation of the 
function GetMessage at the post line. In step 1706, the routine calls the function PostMessage of the new 
operating system with the retrieved message and returns. Alternatively, the routine that simulates a 
WM__MOUSEMOVE message could invoke a function SetCursorPos of the new operating system, which 
effectively simulates a WM_MOUSEMOVE message. 

30 Figure 18 is a flow diagram of a thunk window procedure. Each thunk callback routine operates in a 
similar way. In step 1801, the routine determines which old window handle corresponds to the window 
handle passed by the new operating system. The new operating system uses handles that do not 
necessarily correspond to the actual handles used by the old operating system. Consequently, the SGA 
maintains a mapping between handles of the old operating system and corresponding handles in the new 

35 operating system. In step 1802, the routine invokes the SGAEngine routine to simulate the processing of the 
window procedure by the application program and returns. 

Figure 19 is a flow diagram of the routine ThunkRegisterClass. In step 1901, the routine selects the next 
unused thunk window procedure. In step 1902, the routine establishes a correspondence between the class 
name and the selected thunk window procedure. Every time a window is created of this class, the selected 

40 window procedure is used as the thunk window procedure based on this correspondence. In step 1 903, the 
routine retrieves the parameters for the invocation of the function RegisterClass from the log file at the line 
number indicated by the passed call line. In step 1904, the routine sets the address of the window 
procedure to that of the selected thunk window procedure. In step 1905, the procedure calls the function 
RegisterClass of the new operating system. In step 1906, the routine determines if the return values of the 

45 invocation of function RegisterClass for the new operating system corresponds to the return values of the 
invocation of the function RegisterClass for the old operating system as indicated by the return line in the 
log file and reports an error message if they do not correspond. The routine then returns. 

Figure 20 is a flow diagram of the routine ThunkCreate Window. In step 2001 , the routine retrieves the 
passed parameters for the invocation of function CreateWindow from the log file at the line number 

so indicated by the passed call line. In step 2002, the routine determines the new window handle for the 
passed parent window, if one has been assigned. In step 2003, the routine determines the new menu 
handle of the passed menu, if one has been assigned. In step 2004, the routine determines the new handle 
for the instance of this application, the SGA. In step 2005, th routine gets the return parameters from the 
log file at the line number indicated by the passed return line. In step 2006, the routine calls the function 

55 CreateWindow of the new operating system, passing the new parameters (e.g., new handles). In step 2007, 
the routine establishes the correspondence betwe n the n w handle returned by the new operating system 
and the old handle used by the old operating system as indicated by the return parameters in the log file. In 
step 2008, the routine det rmines whether the return parameters from the invocation of the function 
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CreateWindow of the new operating system corresponds to the return parameters of the invocation of 
function CreateWindow in the old operating system as indicated by the return line in the log file and reports 
an error if they do not correspond. The routine then returns. 

Figure 21 is a flow diagram .of the procedure ThunkDestroy Window. In step 2101, the routine retrieves 

5 the passed parameters from the log file at the line number indicated by the passed call line. In step 2102, 
the routine determines the new window handle that corresponds to the old window handle. In step 2103, the 
routine retrieves the returned parameters from the log file at the line number indicated by the passed return 
line. In step 2104, the routine invokes the function Destroy Window of the new operating system. In step 
2104, the routine compares the return value of the invocation of the function Destroy Window of the new 

w operating system with the invocation of the function DestroyWindow of the old operating system, as 
indicated by the retrieved return parameters and reports an error if there is a difference. The routine then 
returns. 

Figure 22 is a flow diagram of a template thunk function. The thunk function is passed the line number 
in the log file corresponding to an invocation (call line) and return (return line) of the function. In steps 2201 

75 through 2202, the thunk function retrieves the passed parameters from the log file. In steps 2203 through 
2204, the thunk function retrieves the returned parameters from the log file. In step 2205, the thunk function 
retrieves the new handles that correspond to any old handle passed as a parameter. In step 2206, the 
routine invokes functions to simulate the function in the old operating system in the new operating system. 
In step 2207, the thunk function sets the correspondence between any new handles returned by the new 

20 operating system and the old handles of the old operating system. In step 2208, if the returned parameters 
from the simulated function do not correspond to the return parameters from the log file, then an error is 
reported in step 2209 and then the routine returns. 

Figure 23 is a block diagram of an alternate embodiment of the present invention. A real-time logger 
2302 intercepts service requests (function calls) of an application program 2301 intended for an old server 

25 program and sends the request to a simulator program 2303. The simulator program maps the received 
requests to service requests of the new server program 2304. The new server program performs these 
requests and passes results through the simulator to the real-time logger, which returns to the application 
program. Similarly, when the new server program invokes a callback routine, the simulator program routes 
the invocation to the logger which invokes the appropriate callback routine of the application program. The 

30 new server program inputs external events and routes indicators of events to the application program 
through the simulator and real-tame logger. 

One skilled in the art would appreciate that methods and systems of the present invention can be used 
to simulate the execution of programs that use an API provided by other than an operating system in 
conjunction with a graphical user interface. For example, a database system (server program) may provide 

35 various functions that comprise its API. The interaction between application programs (client program) and 
the database system can be recorded during an execution of the application program. This recorded 
interaction can then be used to simulate the application program and to test a new database system. 

One skilled in the art would also appreciate that the new operating system could be simply the old 
operating system with certain functions rewritten, enhanced, or modified. In this case, although existing 

40 application programs can execute under the new operating system, the simulation system can be used to 
check the parameters returned by functions of the new operating system and parameters passed to 
callback routines by the new operating system. 

One skilled in the art would further appreciate that the present invention can be used to compare the 
performance of a client program developed to request services of a first server program with simulated 

45 performance on a second server program. To compare performances, the client program is executed and a 
log is generated. The execution is simulated on both the first and second server programs and performance 
characteristics are recorded. The performance characteristics include simulation overhead for both server 
programs to provide a normalized basis for comparison. Alternatively, a similar approach can be used to 
compare the performance with a third server program. 

so Although the present has been described in terms of a preferred embodiment, it is not intended that the 
invention be limited to this embodiment. Modifications within the spirit of the invention will be apparent to 
those skilled in the art. The scope of the present invention is defined by the claims which follow. 

Claims 

55 

1. A method in a computer system for simulating an xecution of a cli nt program, the client program for 
requesting services of a first server program, the client program specifying parameters for identifying 
variations in behavior of requested services, th method comprising the steps of: 
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during an execution of the client program, logging a plurality of requests for services of the first 
server program, each request including an identification of the requested service and any parameters 
specified with the requested service; and 

requesting a second server program to perform 9 behavior similar to the behavior performed by the 
5 first server program based on the logged requests whereby the behavior of the execution of the client 
computer program is simulated. 

2. The method of claim 1 wherein services are requested by invoking functions provided by the server 
programs and wherein the step of requesting the second server program to perform a behavior 
70 includes the step of invoking functions provided by the second server program. 

The method of claim 1 wherein the step of requesting the second server program to perform a behavior 
includes the steps of: 

for each of a plurality of logged requests, 

selecting one or more services of the second server program to simulate the behavior of the 
logged request; and 

requesting the second server program to perform the selected services. 

4. The method of claim 3 wherein the step of requesting the second server program to perform the 
20 selected services includes the step of passing to the second server program any parameters specified 

with the logged request. 

5. The method of claim 4 including the step of before passing a parameter to the second server program, 
mapping the parameter from a parameter generated by the first server program to a parameter 

25 generated by the second server program. 

6. The method of claim 5 wherein the step, of mapping includes the step of mapping a computer system 
generated handle. 

The method of claim 1 wherein services are requested by invoking functions provided by the server 
programs and wherein the step of requesting the second server program to perform a behavior 
includes the steps of: 

associating a thunk function with each function provided by the first server program, each thunk 
function having a prototype similar to the prototype of the associated function of the first server 
program; and 

invoking the thunk function associated with the function of a logged request to simulate the 
behavior of logged request. 

8. The method of claim 7 wherein the step of invoking the thunk function includes the step of passing a 
40 parameter analogous to a parameter of the logged request. 

9. The method of claim 8 including the step of before passing a parameter to the second server program, 
mapping the parameter from a parameter generated by the first server program to a parameter 
generated by the second server program. 

45 

10. The method of claim 7 including the step of: 

during the invocation of the thunk function, invoking one or more functions of the second server 
program to simulate the behavior of the function associated with the thunk function. 

50 11. The method of claim 10 including the step of: 

upon return from a function of the second server program, specifying return parameters to be 
returned by the thunk function. 

12. The method of claim 1 wherein services are requested by invoking functions provided by the serv r 
55 programs and wherein the step of logging a plurality of requests for a servic of the first server 
program includes the step of logging each return from an invoked function, each logged return 
including an identification of the requested service and any parameter returned by the invoked function. 



3. 
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13. The method of claim 1 wherein the step of logging requests includes the step of sending the request to 
a simulation program that controls the requesting of the second server program. 

14. The method of claim 13 including the step of suppressing the sending of requests to the first server 
5 program. 

15. The method of claim 1 wherein the step of logging includes the step of logging invocations of callback 
routines, and including the step of associating a thunk callback routine with, each callback routine 
wherein the thunk callback routine simulates the behavior of the associated callback when invoked by 

70 the second server program. 

16. The method of claim 1 wherein the first server program is an operating system and the second server 
program is a different version of the same operating system. 

75 17. The method of claim 1 wherein the first server program is an operating system and the second server 
program is a different operating system. 

18. A method in a computer system for comparing the performance between execution of a client program 
with a first* server program and execution of the client program with a second server program, the client 

20 program for requesting services of a third server program, the method comprising the steps of: 

during an execution of the client program, logging a plurality of requests for a service of the third 
server program, each request including an identification of the requested service; 

simulating the execution of the client program with the first server program by selecting logged 
requests, requesting the first server program to perform the requested behavior of each selected 
25 logged request, and recording characteristics of the performance of the request by the first server 
program; 

simulating the execution of the client program with the second server program by selecting logged 
requests, requesting the second server program to. perform the requested behavior of each selected 
logged request and recording characteristics of the performance of the request by the second server 
30 program; and 

analyzing the recorded characteristics of the performance of requests by the first server program 
and the second server program. 

19. The method of claim 18 wherein the steps of recording the performance characteristics record timing 
35 information. 

20. The method of claim 19 wherein the step of simulating the execution of the client program with the first 
server program are performed on a first computer and the step of simulating the execution of the client 
program with the second server program is performed on a second computer, the first computer and 

40 the second computer having different architectures. 

21. The method of claim 20 wherein the step of logging is performed on a third computer having an 
architecture different from the architecture of the first computer and the second computer. 

45 22. A method in a computer system for cooperatively executing a client computer program with a second 
server program, the client computer program developed for requesting services of a first server 
program, the client program specifying a service name and parameters for the requested services, the 
method comprising the steps of: 

during an execution of the client program on the computer system, 
50 intercepting a plurality of requests for services of the first server program, each request including a 

service name and parameters; and 

sending each intercepted request for service to a mapping program; 

upon receipt of a sent request by the mapping program, requesting the second service, program to 
perform the behavior of the received request; and 
55 sending to the client program any parameters returned by th s cond service program whereby the 

client program continues xecution. 
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23. The method of claim 22 wherein the client program ex cutes on a first computer and the second server 
program executes on a second computer. 

24. The method of claim 23 wherein the mapping program executes on the same computer as the client 
program and including the step of sending requests for services of the second service program from 
the. first computer to the second computer. 

25. The method of claim 22 wherein the services are requested by invoking functions provided by the 
service programs and wherein the step of requesting the second server program to perform a behavior 
includes the step of invoking functions provided by the second server program. 

26. The method of claim 22 wherein the step of requesting the second server program to perform a 
behavior includes the steps of: 

for a plurality of sent requests, 

selecting one or more services of the second server program to simulate the behavior of the sent 
requests; and 

requesting the second server program to perform the selected services. 
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